mirror of
https://github.com/expressjs/expressjs.com.git
synced 2026-02-26 03:04:58 +00:00
i18n: new crowdin translations (#2177)
Co-authored-by: Crowdin Bot <support+bot@crowdin.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
daf3c91d03
commit
fbcca21a9a
@@ -12,8 +12,8 @@ module: mw-home
|
||||
|
||||
Estos son algunos módulos de middleware de Express:
|
||||
|
||||
| [express-slash](https://github.com/ericf/express-slash): módulo de middleware de Express para aquellos que son estrictos sobre las barras inclinadas finales. | Description |
|
||||
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Módulo Middleware | Description |
|
||||
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [body-parser](/{{page.lang}}/resources/middleware/body-parser.html) | Parse HTTP request body. |
|
||||
| [compression](/{{page.lang}}/resources/middleware/compression.html) | Compress HTTP responses. |
|
||||
| [connect-rid](/{{page.lang}}/resources/middleware/connect-rid.html) | Generate unique request ID. |
|
||||
@@ -38,7 +38,7 @@ These are some additional popular middleware modules.
|
||||
|
||||
{% include community-caveat.html %}
|
||||
|
||||
| [express-slash](https://github.com/ericf/express-slash): módulo de middleware de Express para aquellos que son estrictos sobre las barras inclinadas finales. | Description |
|
||||
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [helmet](https://github.com/helmetjs/helmet): módulo para ayudar a proteger las aplicaciones estableciendo varias cabeceras HTTP. | Helps secure your apps by setting various HTTP headers. |
|
||||
| [passport](https://github.com/jaredhanson/passport): módulo de middleware de Express para la autenticación. | Authentication using "strategies" such as OAuth, OpenID and many others. See [passportjs.org](https://passportjs.org/) for more information. |
|
||||
| Módulo Middleware | Description |
|
||||
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [helmet](https://github.com/helmetjs/helmet) | Helps secure your apps by setting various HTTP headers. |
|
||||
| [passport](https://github.com/jaredhanson/passport) | Authentication using "strategies" such as OAuth, OpenID and many others. See [passportjs.org](https://passportjs.org/) for more information. |
|
||||
|
||||
@@ -19,7 +19,7 @@ Route definition takes the following structure:
|
||||
app.METHOD(PATH, HANDLER)
|
||||
```
|
||||
|
||||
Where:
|
||||
Donde:
|
||||
|
||||
- `app` es una instancia de `express`.
|
||||
- `METHOD` is an [HTTP request method](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods), in lowercase.
|
||||
|
||||
@@ -225,10 +225,10 @@ cookies:
|
||||
- [cookie-session](https://www.npmjs.com/package/cookie-session)
|
||||
que substitui o middleware `express.cookieSession` integrado no Express 3.x.
|
||||
|
||||
A principal diferença entre estes dois módulos é como eles salvam os dados da sessão de cookie. The [express-session](https://www.npmjs.com/package/express-session) middleware stores session data on the server; it only saves the session ID in the cookie itself, not session data. By default, it uses in-memory storage and is not designed for a production environment. In production, you'll need to set up a scalable session-store; see the list of [compatible session stores](https://github.com/expressjs/session#compatible-session-stores).
|
||||
A principal diferença entre estes dois módulos é como eles salvam os dados da sessão de cookie. O [express-session](https://www.npmjs.com/package/express-session) middleware armazena os dados de sessão no servidor; apenas salva o ID da sessão no próprio cookie, não nos dados da sessão. Por padrão, ele usa armazenamento de memória e não é projetado para um ambiente de produção. Na produção, você precisará configurar uma loja de sessão escalável; ver a lista de [lojas de sessões compatíveis](https://github.com/expressjs/session#compatible-session-stores).
|
||||
|
||||
Em contrapartida, o middleware [cookie-session](https://www.npmjs.com/package/cookie-session)
|
||||
implementa um armazenamento apoiado em cookies: ele serializa a sessão inteira para o cookie, ao invés de apenas a chave da sessão. Use apenas quando os dados da sessão são relativamente pequenos e facilmente codificados como números primitivos(ao invés de objetos). Only use it when session data is relatively small and easily encoded as primitive values (rather than objects). Apesar de navegadores supostamente suportarem pelo menos 4096 bytes por cookie, para assegurar que você não exceda o limite, não exceda
|
||||
implementa um armazenamento apoiado em cookies: ele serializa a sessão inteira para o cookie, ao invés de apenas a chave da sessão. Use apenas quando os dados da sessão são relativamente pequenos e facilmente codificados como números primitivos(ao invés de objetos). Use isso apenas quando os dados da sessão são relativamente pequenos e facilmente codificados como valores primitivos (em vez de objetos). Apesar de navegadores supostamente suportarem pelo menos 4096 bytes por cookie, para assegurar que você não exceda o limite, não exceda
|
||||
um tamanho de 4093 bytes por domínio. Além disso, esteja ciente de que os dados do cookie serão visíveis para o cliente, portanto se
|
||||
houver razão para mantê-los seguros ou obscuros, então o express-session pode ser uma escolha melhor.
|
||||
|
||||
@@ -287,37 +287,37 @@ app.use(session({
|
||||
}))
|
||||
```
|
||||
|
||||
## Prevent brute-force attacks against authorization
|
||||
## Evite ataques brutos contra autorização
|
||||
|
||||
Make sure login endpoints are protected to make private data more secure.
|
||||
Certifique-se de que os endpoints de login estejam protegidos para tornar os dados privados mais seguros.
|
||||
|
||||
A simple and powerful technique is to block authorization attempts using two metrics:
|
||||
Uma técnica simples e poderosa é bloquear tentativas de autorização usando duas métricas:
|
||||
|
||||
1. The number of consecutive failed attempts by the same user name and IP address.
|
||||
2. The number of failed attempts from an IP address over some long period of time. For example, block an IP address if it makes 100 failed attempts in one day.
|
||||
1. O número de tentativas consecutivas com o mesmo nome de usuário e endereço IP.
|
||||
2. O número de tentativas falhadas de um endereço IP por um longo período de tempo. Por exemplo, bloqueie um endereço IP se fizer 100 tentativas falhadas em um dia.
|
||||
|
||||
[rate-limiter-flexible](https://github.com/animir/node-rate-limiter-flexible) package provides tools to make this technique easy and fast. You can find [an example of brute-force protection in the documentation](https://github.com/animir/node-rate-limiter-flexible/wiki/Overall-example#login-endpoint-protection)
|
||||
[rate-limiter-flexible](https://github.com/animir/node-rate-limiter-flexible) pacote fornece ferramentas para tornar essa técnica fácil e rápida. Você pode encontrar [um exemplo de proteção brute-force na documentação](https://github.com/animir/node-rate-limiter-flexible/wiki/Overall-example#login-endpoint-protection)
|
||||
|
||||
## Ensure your dependencies are secure
|
||||
## Certifique-se de que suas dependências estejam seguras
|
||||
|
||||
Using npm to manage your application's dependencies is powerful and convenient. But the packages that you use may contain critical security vulnerabilities that could also affect your application. The security of your app is only as strong as the "weakest link" in your dependencies.
|
||||
Usar o npm para gerenciar as dependências do seu aplicativo é poderoso e conveniente. Mas os pacotes que você usa podem conter vulnerabilidades de segurança críticas que também podem afetar sua aplicação. A segurança do seu aplicativo só é forte como o link "mais fraco" em suas dependências.
|
||||
|
||||
Since npm@6, npm automatically reviews every install request. Also, you can use `npm audit` to analyze your dependency tree.
|
||||
Desde npm@6, npm revisa automaticamente toda requisição de instalação. Além disso, você pode usar o `npm audit` para analisar sua árvore de dependências.
|
||||
|
||||
```bash
|
||||
$ npm audit
|
||||
```
|
||||
|
||||
If you want to stay more secure, consider [Snyk](https://snyk.io/).
|
||||
Se você deseja ficar mais seguro, considere [Snyk](https://snyk.io/).
|
||||
|
||||
Snyk offers both a [command-line tool](https://www.npmjs.com/package/snyk) and a [Github integration](https://snyk.io/docs/github) that checks your application against [Snyk's open source vulnerability database](https://snyk.io/vuln/) for any known vulnerabilities in your dependencies. Install the CLI as follows:
|
||||
Snyk oferece tanto uma [ferramenta de linha de comando](https://www.npmjs.com/package/snyk) quanto uma [integração com um Github](https://snyk.io/docs/github) que verifica a sua aplicação no [banco de dados de vulnerabilidades de fonte aberta do Snyk](https://snyk.io/vuln/) para quaisquer vulnerabilidades conhecidas em suas dependências. Instalar CLI da seguinte forma:
|
||||
|
||||
```bash
|
||||
$ npm install -g snyk
|
||||
$ cd your-app
|
||||
```
|
||||
|
||||
Use this command to test your application for vulnerabilities:
|
||||
Use este comando para testar suas vulnerabilidades:
|
||||
|
||||
```bash
|
||||
$ snyk test
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
layout: page
|
||||
title: Desenvolvendo mecanismos de modelo para o Express
|
||||
description: Learn how to develop custom template engines for Express.js using app.engine(), with examples on creating and integrating your own template rendering logic.
|
||||
description: Aprenda a desenvolver motores de modelos personalizados para Express.js usando app.engine(), com exemplos sobre como criar e integrar sua própria lógica de renderização de templates.
|
||||
menu: advanced
|
||||
order: 1
|
||||
redirect_from: " "
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
layout: page
|
||||
title: Health Checks and Graceful Shutdown
|
||||
description: Learn how to implement health checks and graceful shutdown in Express apps to enhance reliability, manage deployments, and integrate with load balancers like Kubernetes.
|
||||
title: Verificação de integridade e Desligamento Gracioso
|
||||
description: Aprenda como implementar verificações de integridade e encerramentos graciosos em aplicativos Express, para melhorar a confiabilidade, gerenciar implantações e integrar com balanceadores de carga como Kubernetes.
|
||||
menu: advanced
|
||||
order: 5
|
||||
redirect_from: " "
|
||||
---
|
||||
|
||||
# Health Checks and Graceful Shutdown
|
||||
# Verificação de integridade e Desligamento Gracioso
|
||||
|
||||
## Graceful shutdown
|
||||
## Desligamento Gracioso
|
||||
|
||||
When you deploy a new version of your application, you must replace the previous version. The process manager you're using will first send a SIGTERM signal to the application to notify it that it will be killed. Once the application gets this signal, it should stop accepting new requests, finish all the ongoing requests, clean up the resources it used, including database connections and file locks then exit.
|
||||
|
||||
@@ -26,7 +26,7 @@ process.on('SIGTERM', () => {
|
||||
})
|
||||
```
|
||||
|
||||
## Health checks
|
||||
## Verificações de integridade
|
||||
|
||||
A load balancer uses health checks to determine if an application instance is healthy and can accept requests. For example, [Kubernetes has two health checks](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/):
|
||||
|
||||
|
||||
@@ -119,7 +119,7 @@ designando uma lista de nomes separados por vírgulas:
|
||||
$ DEBUG=http,mail,express:* node index.js
|
||||
```
|
||||
|
||||
## Advanced options
|
||||
## Opções avançadas
|
||||
|
||||
When running through Node.js, you can set a few environment variables that will change the behavior of the debug logging:
|
||||
|
||||
@@ -135,9 +135,9 @@ When running through Node.js, you can set a few environment variables that will
|
||||
|
||||
The environment variables beginning with `DEBUG_` end up being
|
||||
converted into an Options object that gets used with `%o`/`%O` formatters.
|
||||
See the Node.js documentation for
|
||||
Veja a documentação do Node.js para
|
||||
[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options)
|
||||
for the complete list.
|
||||
para a lista completa.
|
||||
|
||||
{% endcapture %}
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
---
|
||||
layout: page
|
||||
title: Manipulação de erros do Express
|
||||
description: Understand how Express.js handles errors in synchronous and asynchronous code, and learn to implement custom error handling middleware for your applications.
|
||||
description: Entenda como o Express.js lida com erros em código síncrono e assíncrono e aprenda a implementar erro personalizado de manipulação de intermediários para seus aplicativos.
|
||||
menu: guide
|
||||
order: 6
|
||||
redirect_from: " "
|
||||
@@ -9,18 +9,18 @@ redirect_from: " "
|
||||
|
||||
# Manipulação de erros
|
||||
|
||||
_Error Handling_ refers to how Express catches and processes errors that
|
||||
occur both synchronously and asynchronously. Express comes with a default error
|
||||
handler so you don't need to write your own to get started.
|
||||
_Manipulação de erros_ refere-se a como as capturas Expressas e processa erros que
|
||||
ocorrem de forma sincronizada e assíncrona. Express vem com um manipulador de erro padrão
|
||||
para que você não precise escrever o seu próprio para começar.
|
||||
|
||||
## Catching Errors
|
||||
## Captura de Erros
|
||||
|
||||
It's important to ensure that Express catches all errors that occur while
|
||||
running route handlers and middleware.
|
||||
É importante garantir que Express capture os erros que ocorrem enquanto
|
||||
está rodando manipuladores de rotas e intermediários.
|
||||
|
||||
Errors that occur in synchronous code inside route handlers and middleware
|
||||
require no extra work. If synchronous code throws an error, then Express will
|
||||
catch and process it. Por exemplo:
|
||||
Erros que ocorrem no código síncrono dentro dos manipuladores de rota e middleware
|
||||
não exigem trabalho extra. Se o código síncrono lançar um erro, então o Express irá
|
||||
capturá-lo e processá-lo. Por exemplo:
|
||||
|
||||
```js
|
||||
app.get('/', (req, res) => {
|
||||
@@ -28,10 +28,9 @@ app.get('/', (req, res) => {
|
||||
})
|
||||
```
|
||||
|
||||
Defina funções de middleware de manipulação de erros da mesma
|
||||
forma que outras funções de middleware, exceto que funções de
|
||||
manipulação de erros possuem quatro argumentos ao invés de três:
|
||||
`(err, req, res, next)`. Por exemplo:
|
||||
Para erros retornados de funções assíncronas, invocados pelos manipuladores de rota
|
||||
e intermediário, você deve passá-los para a função `next()`, onde o Express irá capturá-los a
|
||||
e processá-los. Por exemplo:
|
||||
|
||||
```js
|
||||
app.get('/', (req, res, next) => {
|
||||
@@ -57,8 +56,8 @@ app.get('/user/:id', async (req, res, next) => {
|
||||
})
|
||||
```
|
||||
|
||||
If `getUserById` throws an error or rejects, `next` will be called with either
|
||||
the thrown error or the rejected value. If no rejected value is provided, `next`
|
||||
Se `getUserById` lança um erro ou rejeita, `next` será chamado com
|
||||
o erro lançado ou o valor rejeitado. If no rejected value is provided, `next`
|
||||
will be called with a default Error object provided by the Express router.
|
||||
|
||||
Se passar qualquer coisa para a função `next()`
|
||||
|
||||
@@ -390,15 +390,15 @@ Express 5.
|
||||
|
||||
**Note:** In Express 5, `res.sendFile()` uses the `mime-types` package for MIME type detection, which returns different Content-Type values than Express 4 for several common file types:
|
||||
|
||||
- JavaScript files (.js): now "text/javascript" instead of "application/javascript"
|
||||
- JSON files (.json): now "application/json" instead of "text/json"
|
||||
- CSS files (.css): now "text/css" instead of "text/plain"
|
||||
- XML files (.xml): now "application/xml" instead of "text/xml"
|
||||
- Font files (.woff): now "font/woff" instead of "application/font-woff"
|
||||
- SVG files (.svg): now "image/svg+xml" instead of "application/svg+xml"
|
||||
- Arquivos JavaScript (.js): agora "text/javascript" ao invés de "application/javascript"
|
||||
- Arquivos JSON (.json): agora "application/json" em vez de "text/json"
|
||||
- Arquivos CSS (.css): agora "text/css" em vez de "text/plain"
|
||||
- Arquivos XML (.xml): agora "application/xml" em vez de "text/xml"
|
||||
- Arquivos de fonte (.woff): agora "font/woff" em vez de "application/font-woff"
|
||||
- Arquivos SVG (.svg): agora "image/svg+xml" em vez de "application/svg+xml"
|
||||
|
||||
{% capture codemod-camelcase-sendfile %}
|
||||
You can replace the deprecated signatures with the following command:
|
||||
Você pode substituir as assinaturas obsoletas pelo seguinte comando:
|
||||
|
||||
```plain-text
|
||||
npx codemod@latest @expressjs/camelcase-sendfile
|
||||
|
||||
@@ -1,25 +1,25 @@
|
||||
---
|
||||
layout: page
|
||||
title: Overriding the Express API
|
||||
description: Discover how to customize and extend the Express.js API by overriding methods and properties on the request and response objects using prototypes.
|
||||
title: Sobrescrevendo a API Express
|
||||
description: Descubra como personalizar e estender a API do Express.js substituindo métodos e propriedades nos objetos de solicitação e resposta usando protótipos.
|
||||
menu: guide
|
||||
order: 4
|
||||
---
|
||||
|
||||
# Overriding the Express API
|
||||
# Sobrescrevendo a API Express
|
||||
|
||||
The Express API consists of various methods and properties on the request and response objects. These are inherited by prototype. There are two extension points for the Express API:
|
||||
A API do Express consiste de vários métodos e propriedades nos objetos de solicitação e resposta. Estas são herdadas pelo protótipo. Há dois pontos de extensão para a API Express:
|
||||
|
||||
1. The global prototypes at `express.request` and `express.response`.
|
||||
1. Os protótipos globais em `express.request` e `express.response`.
|
||||
2. App-specific prototypes at `app.request` and `app.response`.
|
||||
|
||||
Altering the global prototypes will affect all loaded Express apps in the same process. If desired, alterations can be made app-specific by only altering the app-specific prototypes after creating a new app.
|
||||
|
||||
## Methods
|
||||
## Métodos
|
||||
|
||||
You can override the signature and behavior of existing methods with your own, by assigning a custom function.
|
||||
|
||||
Following is an example of overriding the behavior of [res.sendStatus](/4x/api.html#res.sendStatus).
|
||||
A seguir é um exemplo de substituição do comportamento de [res.sendStatus](/4x/api.html#res.sendStatus).
|
||||
|
||||
```js
|
||||
app.response.sendStatus = function (statusCode, type, message) {
|
||||
@@ -32,18 +32,18 @@ app.response.sendStatus = function (statusCode, type, message) {
|
||||
|
||||
The above implementation completely changes the original signature of `res.sendStatus`. It now accepts a status code, encoding type, and the message to be sent to the client.
|
||||
|
||||
The overridden method may now be used this way:
|
||||
O método sobrescrito agora pode ser usado dessa maneira:
|
||||
|
||||
```js
|
||||
res.sendStatus(404, 'application/json', '{"error":"resource not found"}')
|
||||
```
|
||||
|
||||
## Properties
|
||||
## Propriedades
|
||||
|
||||
Properties in the Express API are either:
|
||||
As propriedades da API Express também são:
|
||||
|
||||
1. Assigned properties (ex: `req.baseUrl`, `req.originalUrl`)
|
||||
2. Defined as getters (ex: `req.secure`, `req.ip`)
|
||||
1. Propriedades atribuídas (ex: `req.baseUrl`, `req.originalUrl`)
|
||||
2. Definido como getters (ex: `req.secure`, `req.ip`)
|
||||
|
||||
Since properties under category 1 are dynamically assigned on the `request` and `response` objects in the context of the current request-response cycle, their behavior cannot be overridden.
|
||||
|
||||
|
||||
@@ -39,6 +39,6 @@ These are some additional popular middleware modules.
|
||||
{% include community-caveat.html %}
|
||||
|
||||
| Módulo de Middleware | Descrição |
|
||||
| ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [st](https://github.com/isaacs/st) | [helmet](https://github.com/helmetjs/helmet): módulo para ajudar a proteger seus aplicativos configurando vários cabeçalhos HTTP. |
|
||||
| [passport](https://github.com/jaredhanson/passport): módulo middleware do Express para autenticação. | Authentication using "strategies" such as OAuth, OpenID and many others. Veja [passportjs.org](https://passportjs.org/) para obter mais informações. |
|
||||
| [passport](https://github.com/jaredhanson/passport) | Authentication using "strategies" such as OAuth, OpenID and many others. Veja [passportjs.org](https://passportjs.org/) para obter mais informações. |
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
layout: page
|
||||
title: Express utilities
|
||||
title: Express utilidades
|
||||
description: Discover utility modules related to Express.js and Node.js, including tools for cookies, CSRF protection, URL parsing, routing, and more to enhance your applications.
|
||||
menu: resources
|
||||
order: 4
|
||||
redirect_from: " "
|
||||
---
|
||||
|
||||
## Express utility functions
|
||||
## Express funções utilitárias
|
||||
|
||||
The [pillarjs](https://github.com/pillarjs) GitHub organization contains a number of modules
|
||||
for utility functions that may be generally useful.
|
||||
|
||||
@@ -27,7 +27,7 @@ preferir. Visualize os seguintes exemplos para obter inspiração:
|
||||
Além disso, existem extensões de terceiros para o Express, que
|
||||
simplificam alguns desses padrões:
|
||||
|
||||
- [Resourceful routing](https://github.com/expressjs/express-resource)
|
||||
- [Roteamento de recursos](https://github.com/expressjs/express-resource)
|
||||
|
||||
## Como eu defino modelos?
|
||||
|
||||
|
||||
@@ -35,7 +35,7 @@ conexões. O aplicativo responde com "Hello World!" à solicitações
|
||||
para a URL raiz (`/`) ou _rota_. Para
|
||||
todos os outros caminhos, ele irá responder com um **404 Não Encontrado**.
|
||||
|
||||
### Running Locally
|
||||
### Executando localmente
|
||||
|
||||
Primeiro crie um diretório chamado `myapp`,
|
||||
mude para ele e execute o `npm init`. Em seguida
|
||||
|
||||
Reference in New Issue
Block a user