Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 1 addition & 30 deletions src/content/docs/de/4x/guide/writing-middleware.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,36 +19,7 @@ Wenn die aktuelle Middleware-Funktion den Request-Antwort-Zyklus nicht beendet,

Die folgende Abbildung zeigt die Elemente eines Middleware-Funktionsaufrufs:

<div class="tabell-scroller">
<table id="mw-Abbildung">
<tr>
<td id="mw-fig-imgcell">
<img src="/images/express-mw.png" alt="Elemente eines Middleware Funktionsaufrufs" id="mw-fig-img" />
</td>
<td class="mw-fig-callouts">
<div class="callout" id="callout1">HTTP-Methode, für die die Middleware-Funktion gilt.</div>

<div class="callout" id="callout2">
Pfad (Route), für den die Middleware-Funktion gilt.
</div>

<div class="callout" id="callout3">
Die Middleware-Funktion.
</div>

<div class="callout" id="callout4">
Callback-Argument an die Middleware-Funktion, genannt "Next" durch Konvention.
</div>

<div class="callout" id="callout5">
HTTP [response](/api/response) argument to the middleware function, called "res" by convention.
</div>

<div class="callout" id="callout6">HTTP [request](/api/request) argument to the middleware function, called "req" by convention.</div>
</td>
</tr>
</table>
</div>
![Elemente einer Middleware-Funktion aufruf](/images/express-mw.png)

Beginnend mit Express 5 ruft Middleware-Funktionen, die ein Versprechen zurückgeben, `next(value)` auf, wenn sie einen Fehler ablehnen oder werfen. `next` wird entweder mit dem abgelehnten Wert oder mit dem Wurffehler aufgerufen.

Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/de/5x/guide/routing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ app.get('/', (req: Request, res: Response) => {

## Routenmethoden

Eine Route-Methode wird von einer der HTTP-Methoden abgeleitet und an eine Instanz der Klasse \`express angehängt.
Eine Route-Methode wird von einer der HTTP-Methoden abgeleitet und an eine Instanz der Klasse `express` angehängt.

Der folgende Code ist ein Beispiel für Routen, die für die `GET` und die `POST` Methoden im Root der App definiert sind.

Expand Down Expand Up @@ -153,7 +153,7 @@ app.get('/random.text', (req: Request, res: Response) => {
});
```

<Alert type="warnung">
<Alert type="alert">

The characters `?`, `+`, `*`, `[]`, `()`, and `!` are reserved and cannot be used as literal characters in route paths, and braces are reserved for [optional segments](#optional-segments). Benutze `\`, um sie bei Bedarf zu maskieren.

Expand Down Expand Up @@ -227,7 +227,7 @@ const sendParams = (req: Request<{ userId: string; bookId: string }>, res: Respo
app.get('/users/:userId/books/:bookId', sendParams);
```

<Alert type="warnung">
<Alert type="alert">

The name of route parameters must be a valid JavaScript identifier. Other names can be used by quoting them, for example `:"user-name"`.

Expand All @@ -247,7 +247,7 @@ Request URL: http://localhost:3000/plantae/Prunus.persica
req.params: { "genus": "Prunus", "species": "persica" }
```

<Alert type="warnung">
<Alert type="alert">

Regexp characters are not supported inside string paths, so a parameter cannot be restricted with a suffix such as `:userId(\d+)`. Use an array of paths or a full regular expression instead.
Weitere Informationen finden Sie in der Syntax [Pfadroute Match](/guide/migrating-5#path-route-matching-syntax).
Expand Down Expand Up @@ -325,7 +325,7 @@ app.get('/:file{.:ext}', (req: Request, res: Response) => {
The braces can also wrap a whole parameter to make it optional. Note that everything inside the braces is optional, so the position of the slash matters:

```js
app.get('/user/\{:id}', (req, res) => {
app.get('/user/{:id}', (req, res) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -342,7 +342,7 @@ app.get('/order{/:id}', (req, res) => {
```ts
import { type Request, type Response } from 'express';

app.get('/user/\{:id}', (req: Request, res: Response) => {
app.get('/user/{:id}', (req: Request, res: Response) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -356,7 +356,7 @@ app.get('/order{/:id}', (req: Request, res: Response) => {
});
```

Verwechsle die Position des Schrägstrichs im Routenpfad nicht mit der [`strict routing`-Einstellung](/api/application/#application-settings), die sich auf die Anfrage-URL bezieht: Sie steuert, ob eine URL, die mit einem Schrägstrich endet, den der Routenpfad nicht verlangt, trotzdem übereinstimmt. Zum Beispiel stimmt eine Anfrage an `/order/` standardmäßig mit der Route `/order{/:id}` überein, gibt aber einen 404-Fehler zurück, wenn strict routing aktiviert ist; der abschließende Schrägstrich von `/user/` ist davon nicht betroffen, weil die Route `/user/\{:id}` ihn verlangt. Alle in den obigen Beispielen kommentierten Anfragen verhalten sich unabhängig von dieser Einstellung gleich.
Verwechsle die Position des Schrägstrichs im Routenpfad nicht mit der [`strict routing`-Einstellung](/api/application/#application-settings), die sich auf die Anfrage-URL bezieht: Sie steuert, ob eine URL, die mit einem Schrägstrich endet, den der Routenpfad nicht verlangt, trotzdem übereinstimmt. Zum Beispiel stimmt eine Anfrage an `/order/` standardmäßig mit der Route `/order{/:id}` überein, gibt aber einen 404-Fehler zurück, wenn strict routing aktiviert ist; der abschließende Schrägstrich von `/user/` ist davon nicht betroffen, weil die Route `/user/{:id}` ihn verlangt. Alle in den obigen Beispielen kommentierten Anfragen verhalten sich unabhängig von dieser Einstellung gleich.

## Routenhandler

Expand Down
31 changes: 1 addition & 30 deletions src/content/docs/es/4x/guide/writing-middleware.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,36 +19,7 @@ Si la función actual de middleware no termina el ciclo de solicitud de respuest

La siguiente figura muestra los elementos de una llamada a una función de middleware:

<div class="rascacielos">
<table id="higuera-mw">
<tr>
<td id="mw-figur-imgcell">
<img src="/images/express-mw.png" alt="Elementos de una llamada a función middleware" id="mw-fig-img" />
</td>
<td class="mw-fig-callouts">
<div class="callout" id="callout1">método HTTP para el cual se aplica la función middleware.</div>

<div class="callout" id="callout2">
Ruta (ruta) para la que se aplica la función middleware.
</div>

<div class="callout" id="callout3">
La función Middleware.
</div>

<div class="callout" id="callout4">
Argumento de llamada a la función middleware, llamado "siguiente" por convención.
</div>

<div class="callout" id="callout5">
HTTP [response](/api/response) argument to the middleware function, called "res" by convention.
</div>

<div class="callout" id="callout6">HTTP [request](/api/request) argument to the middleware function, called "req" by convention.</div>
</td>
</tr>
</table>
</div>
![Elementos de una llamada a función middleware](/images/express-mw.png)

A partir de Express 5, las funciones de middleware que devuelven una Promise llamarán `next(value)` cuando rechacen o lancen un error. `next` será llamado con el valor rechazado o con el error arrojado.

Expand Down
12 changes: 6 additions & 6 deletions src/content/docs/es/5x/guide/routing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ app.get('/random.text', (req: Request, res: Response) => {
});
```

<Alert type="alerta">
<Alert type="alert">

The characters `?`, `+`, `*`, `[]`, `()`, and `!` are reserved and cannot be used as literal characters in route paths, and braces are reserved for [optional segments](#optional-segments). Usa `\` para escapar de ellos si es necesario.

Expand Down Expand Up @@ -227,7 +227,7 @@ const sendParams = (req: Request<{ userId: string; bookId: string }>, res: Respo
app.get('/users/:userId/books/:bookId', sendParams);
```

<Alert type="alerta">
<Alert type="alert">

The name of route parameters must be a valid JavaScript identifier. Other names can be used by quoting them, for example `:"user-name"`.

Expand All @@ -247,7 +247,7 @@ Request URL: http://localhost:3000/plantae/Prunus.persica
req.params: { "genus": "Prunus", "species": "persica" }
```

<Alert type="alerta">
<Alert type="alert">

Regexp characters are not supported inside string paths, so a parameter cannot be restricted with a suffix such as `:userId(\d+)`. Use an array of paths or a full regular expression instead.
Vea la [sintaxis de coincidencia de ruta de ruta](/guide/migrating-5#path-syntax) para más información.
Expand Down Expand Up @@ -325,7 +325,7 @@ app.get('/:file{.:ext}', (req: Request, res: Response) => {
The braces can also wrap a whole parameter to make it optional. Note that everything inside the braces is optional, so the position of the slash matters:

```js
app.get('/user/\{:id}', (req, res) => {
app.get('/user/{:id}', (req, res) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -342,7 +342,7 @@ app.get('/order{/:id}', (req, res) => {
```ts
import { type Request, type Response } from 'express';

app.get('/user/\{:id}', (req: Request, res: Response) => {
app.get('/user/{:id}', (req: Request, res: Response) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -356,7 +356,7 @@ app.get('/order{/:id}', (req: Request, res: Response) => {
});
```

No confundas la posición de la barra en la ruta con la [configuración `strict routing`](/api/application/#application-settings), que trata sobre la URL de la solicitud: controla si una URL que termina en barra sigue coincidiendo cuando la ruta no la exige. Por ejemplo, una solicitud a `/order/` coincide con la ruta `/order{/:id}` por defecto, pero devuelve un error 404 cuando strict routing está habilitado; la barra final de `/user/` no se ve afectada porque la ruta `/user/\{:id}` la exige. Todas las solicitudes comentadas en los ejemplos anteriores se comportan igual independientemente de esa configuración.
No confundas la posición de la barra en la ruta con la [configuración `strict routing`](/api/application/#application-settings), que trata sobre la URL de la solicitud: controla si una URL que termina en barra sigue coincidiendo cuando la ruta no la exige. Por ejemplo, una solicitud a `/order/` coincide con la ruta `/order{/:id}` por defecto, pero devuelve un error 404 cuando strict routing está habilitado; la barra final de `/user/` no se ve afectada porque la ruta `/user/{:id}` la exige. Todas las solicitudes comentadas en los ejemplos anteriores se comportan igual independientemente de esa configuración.

## Manejadores de rutas

Expand Down
31 changes: 1 addition & 30 deletions src/content/docs/fr/4x/guide/writing-middleware.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,36 +19,7 @@ Si la fonction middleware actuelle ne met pas fin au cycle de réponse de requê

La figure suivante montre les éléments d'un appel de fonction middleware :

<div class="défileur de table">
<table id="mw-fig">
<tr>
<td id="mw-fig-imgcell">
<img src="/images/express-mw.png" alt="Éléments d'un appel de fonction middleware" id="mw-fig-img" />
</td>
<td class="mw-fig-callouts">
<div class="callout" id="callout1">méthode HTTP pour laquelle la fonction middleware s'applique.</div>

<div class="callout" id="callout2">
Chemin (route) pour lequel la fonction middleware s'applique.
</div>

<div class="callout" id="callout3">
La fonction middleware.
</div>

<div class="callout" id="callout4">
Argument de rappel à la fonction middleware, appelé "next" par convention.
</div>

<div class="callout" id="callout5">
HTTP [response](/api/response) argument to the middleware function, called "res" by convention.
</div>

<div class="callout" id="callout6">HTTP [request](/api/request) argument to the middleware function, called "req" by convention.</div>
</td>
</tr>
</table>
</div>
![Elements of a middleware function call](/images/express-mw.png)

À partir de Express 5, les fonctions middleware qui retournent une Promise appelleront `next(value)` quand elles rejettent ou lancent une erreur. `next` sera appelé avec la valeur rejetée ou avec l'erreur levée.

Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/fr/5x/guide/routing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ app.all('/secret', (req: Request, res: Response, next: NextFunction) => {

Les chemins de la route, en combinaison avec une méthode de requête, définissent les points de terminaison à partir desquels les requêtes peuvent être faites. Les chemins de route peuvent être des chaînes de caractères ou des expressions régulières. They can also capture values from the URL, as described in [Route parameters](#route-parameters) below.

<Alert type="Infos">
<Alert type="info">

Express utilise [path-to-regexp](https://www.npmjs.com/package/path-to-regexp) v8 pour correspondre aux chemins de route ; consultez la documentation path-to-regexp pour toutes les possibilités dans la définition des chemins de route.
[Express Playground Router](https://bjohansebas.github.io/playground-router/) est un outil pratique pour tester les routes Express de base, bien qu'il ne supporte pas la recherche de patterns.
Expand Down Expand Up @@ -153,7 +153,7 @@ app.get('/random.text', (req: Request, res: Response) => {
});
```

<Alert type="Alerte">
<Alert type="alert">

The characters `?`, `+`, `*`, `[]`, `()`, and `!` are reserved and cannot be used as literal characters in route paths, and braces are reserved for [optional segments](#optional-segments). Utilisez `\` pour les échapper si nécessaire.

Expand Down Expand Up @@ -227,7 +227,7 @@ const sendParams = (req: Request<{ userId: string; bookId: string }>, res: Respo
app.get('/users/:userId/books/:bookId', sendParams);
```

<Alert type="Alerte">
<Alert type="alert">

The name of route parameters must be a valid JavaScript identifier. Other names can be used by quoting them, for example `:"user-name"`.

Expand All @@ -247,7 +247,7 @@ Request URL: http://localhost:3000/plantae/Prunus.persica
req.params: { "genus": "Prunus", "species": "persica" }
```

<Alert type="Alerte">
<Alert type="alert">

Regexp characters are not supported inside string paths, so a parameter cannot be restricted with a suffix such as `:userId(\d+)`. Use an array of paths or a full regular expression instead.
Voir la [syntaxe correspondante à la route des chemins](/en/guide/migrating-5#path-syntax) pour plus d'informations.
Expand Down Expand Up @@ -325,7 +325,7 @@ app.get('/:file{.:ext}', (req: Request, res: Response) => {
The braces can also wrap a whole parameter to make it optional. Note that everything inside the braces is optional, so the position of the slash matters:

```js
app.get('/user/\{:id}', (req, res) => {
app.get('/user/{:id}', (req, res) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -342,7 +342,7 @@ app.get('/order{/:id}', (req, res) => {
```ts
import { type Request, type Response } from 'express';

app.get('/user/\{:id}', (req: Request, res: Response) => {
app.get('/user/{:id}', (req: Request, res: Response) => {
// GET /user/42 => req.params = { id: '42' }
// GET /user/ => req.params = {}
// GET /user => 404, only the parameter is optional
Expand All @@ -356,7 +356,7 @@ app.get('/order{/:id}', (req: Request, res: Response) => {
});
```

Ne confondez pas la position de la barre oblique dans le chemin de la route avec le [paramètre `strict routing`](/api/application/#application-settings), qui concerne l'URL de la requête : il contrôle si une URL se terminant par une barre oblique que le chemin de la route n'exige pas correspond quand même. Par exemple, une requête vers `/order/` correspond par défaut à la route `/order{/:id}`, mais renvoie une erreur 404 lorsque strict routing est activé ; la barre oblique finale de `/user/` n'est pas concernée car la route `/user/\{:id}` l'exige. Toutes les requêtes commentées dans les exemples ci-dessus se comportent de la même manière quel que soit ce paramètre.
Ne confondez pas la position de la barre oblique dans le chemin de la route avec le [paramètre `strict routing`](/api/application/#application-settings), qui concerne l'URL de la requête : il contrôle si une URL se terminant par une barre oblique que le chemin de la route n'exige pas correspond quand même. Par exemple, une requête vers `/order/` correspond par défaut à la route `/order{/:id}`, mais renvoie une erreur 404 lorsque strict routing est activé ; la barre oblique finale de `/user/` n'est pas concernée car la route `/user/{:id}` l'exige. Toutes les requêtes commentées dans les exemples ci-dessus se comportent de la même manière quel que soit ce paramètre.

## Gestionnaires de routes

Expand Down
31 changes: 1 addition & 30 deletions src/content/docs/it/4x/guide/writing-middleware.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,36 +19,7 @@ Se la funzione middleware corrente non termina il ciclo richiesta-risposta, deve

La figura seguente mostra gli elementi di una chiamata di una funzione middleware:

<div class="table-scroller">
<table id="mw-fig">
<tr>
<td id="mw-fig-imgcell">
<img src="/images/express-mw.png" alt="Elementi di una chiamata a funzione middleware" id="mw-fig-img" />
</td>
<td class="mw-fig-callouts">
Metodo <div class="callout" id="callout1">HTTP per il quale si applica la funzione middleware.</div>

<div class="callout" id="callout2">
Percorso (percorso) per il quale si applica la funzione middleware.
</div>

<div class="callout" id="callout3">
La funzione middleware.
</div>

<div class="callout" id="callout4">
Argomento di richiamo alla funzione middleware, chiamato "next" per convenzione.
</div>

<div class="callout" id="callout5">
HTTP [response](/api/response) argument to the middleware function, called "res" by convention.
</div>

<div class="callout" id="callout6">HTTP [request](/api/request) argument to the middleware function, called "req" by convention.</div>
</td>
</tr>
</table>
</div>
![Elementi di una chiamata di una funzione middleware](/images/express-mw.png)

A partire da Express 5, le funzioni middleware che restituiscono una Promise chiameranno `next(value)` quando rifiutano o lanciano un errore. `next` verrà chiamato con il valore rifiutato o con l'errore lanciato.

Expand Down
Loading
Loading