Skip to content

Commit

Permalink
Remove reference to debug module in debugging guide
Browse files Browse the repository at this point in the history
closes #1442
  • Loading branch information
dougwilson committed Sep 29, 2023
1 parent 867a10d commit 22e1ae0
Show file tree
Hide file tree
Showing 16 changed files with 6 additions and 169 deletions.
11 changes: 0 additions & 11 deletions de/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ lang: de

# Debugging bei Express

Express verwendet das Modul [debug](https://www.npmjs.com/package/debug) intern, um Informationen zu Weiterleitungsübereinstimmungen, verwendete Middlewarefunktionen, Anwendungsmodi und den Verlauf des Anforderung/Antwort-Zyklus zu protokollieren.

<div class="doc-box doc-info" markdown="1">
`debug` ist praktisch eine erweiterte Version von `console.log`. Im Gegensatz zu `console.log` müssen jedoch
keine `debug`-Protokolle im Produktionscode auskommentiert werden. Die Protokollierung wird standardmäßig inaktiviert und kann über die Umgebungsvariable `DEBUG` bedingt aktiviert werden.
</div>

Wenn Sie alle in Express verwendeten internen Protokolle anzeigen wollen, legen Sie beim Starten Ihrer Anwendung die Umgebungsvariable `DEBUG` auf `express:*` fest.

```console
Expand Down Expand Up @@ -96,8 +89,6 @@ Wenn Sie nur die Protokolle von der Routerimplementierung sehen wollen, legen Si

## Von `express` generierte Anwendungen

Eine über den Befehl `express` generierte Anwendung verwendet ebenfalls das Modul `debug`. Der Debug-Namespace wird auf den Namen der Anwendung erweitert.

Beispiel: Wenn Sie die Anwendung mit `$ express sample-app` generiert haben, können Sie die Debuganweisungen mit dem folgenden Befehl aktivieren:

```console
Expand All @@ -109,5 +100,3 @@ Sie können mehrere Debug-Namespaces in einer durch Kommas getrennten Namenslist
```console
$ DEBUG=http,mail,express:* node index.js
```

Weitere Informationen zu `debug` finden Sie unter [debug](https://www.npmjs.com/package/debug).
15 changes: 1 addition & 14 deletions en/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ redirect_from: "/guide/debugging.html"
---
# Debugging Express

Express uses the [debug](https://www.npmjs.com/package/debug) module
internally to log information about route matches, middleware functions that are in use, application mode,
and the flow of the request-response cycle.

<div class="doc-box doc-info" markdown="1">
`debug` is like an augmented version of `console.log`, but unlike `console.log`, you don't have to
comment out `debug` logs in production code. Logging is turned off by default and can be conditionally turned on by using the `DEBUG` environment variable.
</div>

To see all the internal logs used in Express, set the `DEBUG` environment variable to
`express:*` when launching your app.

Expand Down Expand Up @@ -99,7 +90,7 @@ To see the logs only from the router implementation set the value of `DEBUG` to

## Applications generated by `express`

An application generated by the `express` command also uses the `debug` module and its debug namespace is scoped to the name of the application.
An application generated by the `express` command uses the `debug` module and its debug namespace is scoped to the name of the application.

For example, if you generated the app with `$ express sample-app`, you can enable the debug statements with the following command:

Expand Down Expand Up @@ -130,7 +121,3 @@ converted into an Options object that gets used with `%o`/`%O` formatters.
See the Node.js documentation for
[`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options)
for the complete list.

## Resources

For more information about `debug`, see the [debug](https://www.npmjs.com/package/debug).
10 changes: 1 addition & 9 deletions es/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,6 @@ lang: es

# Depuración de Express

Express utiliza el módulo [debug](https://www.npmjs.com/package/debug) internamente para registrar información sobre las coincidencias de rutas, las funciones de middleware que se están utilizando, la modalidad de aplicación y el flujo del ciclo de solicitud/respuestas.

<div class="doc-box doc-info" markdown="1">
`debug` es como una versión aumentada de `console.log`, aunque a diferencia de `console.log`, no tiene que comentar los registros `debug` en el código de producción. El registro está desactivado de forma predeterminada y puede activarse condicionalmente utilizando la variable de entorno `DEBUG`.
</div>

Para ver todos los registros internos utilizados en Express, establezca la variable de entorno `DEBUG` en `express:*` cuando inicie la aplicación.

```console
Expand Down Expand Up @@ -95,7 +89,7 @@ Para ver sólo los registros de la implementación de direccionador, establezca

## Aplicaciones generadas por `express`

Una aplicación generada por el mandato `express` también utiliza el módulo `debug`, y el ámbito de su espacio de nombres de depuración se establece en el nombre de la aplicación.
Una aplicación generada por el mandato `express` utiliza el módulo `debug`, y el ámbito de su espacio de nombres de depuración se establece en el nombre de la aplicación.

Por ejemplo, si ha generado la aplicación con `$ express sample-app`, puede habilitar las sentencias de depuración con el siguiente mandato:

Expand All @@ -108,5 +102,3 @@ Puede especificar más de un espacio de nombres de depuración asignando una lis
```console
$ DEBUG=http,mail,express:* node index.js
```

Para obtener más información sobre `debug`, consulte [debug](https://www.npmjs.com/package/debug).
13 changes: 1 addition & 12 deletions fr/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ lang: fr

# Débogage d'Express

Express fait appel au module [debug](https://www.npmjs.com/package/debug) en interne
pour journaliser les informations concernant les correspondances de route, les fonctions middleware utilisées, le
mode de l'application ainsi que le flux du cycle de demande-réponse.

<div class="doc-box doc-info" markdown="1">
Le module `debug` est en quelque sorte une version étendue de `console.log`, mais contrairement à ce dernier,`` vous n'avez pas besoin de mettre en commentaire les journaux de
`debug` dans le code de production. La journalisation est désactivée par défaut et peut être activée de manière conditionnelle à l'aide de la variable d'environnement `DEBUG`.
</div>

Pour afficher tous les journaux internes utilisés dans Express, affectez à la variable d'environnement `DEBUG` la valeur `express:*` lors du lancement de votre application.

```console
Expand Down Expand Up @@ -98,7 +89,7 @@ Pour afficher les journaux uniquement à partir de l'implémentation du routeur,

## Applications générées par la commande `express`

Une application générée par la commande `express` fait également appel au module `debug` et son espace de nom de débogage est délimité par le nom de l'application.
Une application générée par la commande `express` également appel au module `debug` et son espace de nom de débogage est délimité par le nom de l'application.

Ainsi, si vous avez généré l'application à l'aide de `$ express sample-app`, vous pouvez activer les instructions de débogage en exécutant la commande suivante :

Expand All @@ -111,5 +102,3 @@ Vous pouvez spécifier plusieurs espaces de noms de débogage en affectant une l
```console
$ DEBUG=http,mail,express:* node index.js
```

Pour plus d'informations sur le module `debug`, voir [debug](https://www.npmjs.com/package/debug).
11 changes: 0 additions & 11 deletions it/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ lang: it

# Debug di Express

Express utilizza il modulo [debug](https://www.npmjs.com/package/debug)
internamente per registrare le informazioni sulle corrispondenze route, le funzioni middleware in uso, la modalità dell'applicazione
e il flusso del ciclo richiesta/risposta.

<div class="doc-box doc-info" markdown="1">
`debug` corrisponde a una versione estesa di `console.log`, ma diversamente da `console.log`, non è necessario
creare commenti per i log `debug` nel codice di produzione. Il processo di registrazione è disattivato per impostazione predefinita e può essere attivato utilizzando la variabile di ambiente `DEBUG`.
</div>

Per visualizzare tutti i log interni utilizzati in Express, impostare la variabile di ambiente `DEBUG` su
`express:*` quando si avvia l'applicazione.

Expand Down Expand Up @@ -112,5 +103,3 @@ $ DEBUG=sample-app:* node ./bin/www
```console
$ DEBUG=http,mail,express:* node index.js
```

Per ulteriori informazioni su `debug`, consultare [debug](https://www.npmjs.com/package/debug).
8 changes: 0 additions & 8 deletions ja/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,6 @@ lang: ja

# Express のデバッグ

Express は、[debug](https://www.npmjs.com/package/debug) モジュールを内部的に使用して、ルートの一致、使用中のミドルウェア関数、アプリケーション・モード、および要求と応答のサイクルのフローに関する情報をログに記録します。

<div class="doc-box doc-info" markdown="1">
`debug` は、`console.log` の拡張版のようなものですが、`console.log` とは異なり、実動コードで `debug` ログをコメント化する必要はありません。ロギングはデフォルトでオフになっており、`DEBUG` 環境変数を使用して条件付きでオンにすることができます。
</div>

Express で使用されているすべての内部ログを表示するには、アプリケーションの起動時に `DEBUG` 環境変数を `express:*` に設定します。

```console
Expand Down Expand Up @@ -108,5 +102,3 @@ $ DEBUG=sample-app:* node ./bin/www
```console
$ DEBUG=http,mail,express:* node index.js
```

`debug` の詳細については、[debug](https://www.npmjs.com/package/debug) を参照してください。
11 changes: 0 additions & 11 deletions ko/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ lang: ko

# Express 디버깅

Express는 내부적으로 [debug](https://www.npmjs.com/package/debug) 모듈을
사용하여 라우트 일치, 사용 중인 미들웨어 함수, 애플리케이션 모드, 그리고 요청-응답 주기의
플로우에 대한 정보를 로그합니다.

<div class="doc-box doc-info" markdown="1">
`debug``console.log`의 보강된 버전과도 같지만, `console.log`와는 달리
프로덕션 코드에서 `debug` 로그를 주석 처리할 필요가 없습니다. 로깅은 기본적으로 꺼져 있으며, `DEBUG` 환경 변수를 사용하여 조건부로 켤 수 있습니다.
</div>

Express에서 사용되는 모든 내부 로그를 확인하려면, 앱을 실행할 때 `DEBUG` 환경 변수를
`express:*`로 설정하십시오.

Expand Down Expand Up @@ -112,5 +103,3 @@ $ DEBUG=sample-app:* node ./bin/www
```console
$ DEBUG=http,mail,express:* node index.js
```

`debug`에 대한 자세한 정보는 [debug](https://www.npmjs.com/package/debug)를 참조하십시오.
15 changes: 0 additions & 15 deletions pt-br/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,6 @@ lang: pt-br

# Depurando o Express

O Express usa o módulo de [depuração](https://www.npmjs.com/package/debug)
internamente para registrar informações de log sobre a correspondência de rotas, as funções middleware que estão em uso, o modo de
aplicativo, e o fluxo do ciclo solicitação-resposta.

<div class="doc-box doc-info" markdown="1">
O `debug` é como uma versão aumentada do `console.log` mas, diferente do
`console.log`, não é preciso comentar os logs de
`debug` no código na produção. O registro de logs
está desligado por padrão e podem ser ligados condicionadamente
usando a variável de ambiente `DEBUG`.
</div>

Para ver todos os logs interno usados no Express, configure a
variável de ambiente `DEBUG` para
`express:*` ao ativar seu aplicativo.
Expand Down Expand Up @@ -128,6 +116,3 @@ designando uma lista de nomes separados por vírgulas:
```console
$ DEBUG=http,mail,express:* node index.js
```

Para obter mais informações sobre `debug`,
consulte o [debug](https://www.npmjs.com/package/debug).
9 changes: 0 additions & 9 deletions ru/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ lang: ru

# Отладка Express

В Express используется внутренний модуль [debug](https://www.npmjs.com/package/debug) для
регистрации информации о сопоставлениях маршрутов, используемых функциях промежуточной обработки, режиме приложения и выполнении цикла "запрос-ответ".

<div class="doc-box doc-info" markdown="1">
`debug` можно сравнить с расширенной версией `console.log`, но, в отличие от `console.log`, в рабочем коде не нужно добавлять символы комментария к протоколам `debug`. Ведение протокола по умолчанию выключено, но его можно условно активировать с помощью среды переменной `DEBUG`.
</div>

Для просмотра всех внутренних протоколов, используемых в Express, при запуске приложения задайте для переменной среды `DEBUG` значение `express:*`.

```console
Expand Down Expand Up @@ -109,5 +102,3 @@ $ DEBUG=sample-app:* node ./bin/www
```console
$ DEBUG=http,mail,express:* node index.js
```

Дополнительная информация о модуле `debug` приведена на странице [debug](https://www.npmjs.com/package/debug).
8 changes: 0 additions & 8 deletions sk/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,6 @@ lang: sk

# Debuggovanie Express

Express interne používa k logovaniu informácií ohľadom route matchingu, použitých middleware funkciách, aplikačného módu a toku request response cyklu modul [debug](https://www.npmjs.com/package/debug).

<div class="doc-box doc-info" markdown="1">
`debug` je ako rozšírena verzia `console.log`, ale narozdiel od `console.log`, nemusíte zakomentovávať volania `debug` v produkčnom kóde. Logovanie je vypnuté defaultne a je možné ho zapnúť použitím `DEBUG` environment premennej.
</div>

Ak chcete vidieť všetky interné logy Express-u, nastavte pri spúštaní vašej aplikácie environment premennú `DEBUG` na hodnotu
`express:*`.

Expand Down Expand Up @@ -113,5 +107,3 @@ Pomocou čiarkou oddeleného zoznamu názvov môžete špecifikovať viac ako je
```console
$ DEBUG=http,mail,express:* node index.js
```

Pre viac informácií ohľadom `debug` modulu si pozrite [debug](https://www.npmjs.com/package/debug).
13 changes: 1 addition & 12 deletions th/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,6 @@ lang: th
---
# Debugging Express

Express uses the [debug](https://www.npmjs.com/package/debug) module
internally to log information about route matches, middleware functions that are in use, application mode,
and the flow of the request-response cycle.

<div class="doc-box doc-info" markdown="1">
`debug` is like an augmented version of `console.log`, but unlike `console.log`, you don't have to
comment out `debug` logs in production code. Logging is turned off by default and can be conditionally turned on by using the `DEBUG` environment variable.
</div>

To see all the internal logs used in Express, set the `DEBUG` environment variable to
`express:*` when launching your app.

Expand Down Expand Up @@ -98,7 +89,7 @@ To see the logs only from the router implementation set the value of `DEBUG` to

## Applications generated by `express`

An application generated by the `express` command also uses the `debug` module and its debug namespace is scoped to the name of the application.
An application generated by the `express` command uses the `debug` module and its debug namespace is scoped to the name of the application.

For example, if you generated the app with `$ express sample-app`, you can enable the debug statements with the following command:

Expand All @@ -111,5 +102,3 @@ You can specify more than one debug namespace by assigning a comma-separated lis
```console
$ DEBUG=http,mail,express:* node index.js
```

For more information about `debug`, see the [debug](https://www.npmjs.com/package/debug).
9 changes: 0 additions & 9 deletions tr/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,6 @@ redirect_from: "/guide/debugging.html"
---
# Express hata ayıklama

Express, rota eşleştirmeleri, kullanımda olan ara yazılım fonksiyonları, uygulama modu, ve istek-yanıt döngüsü akışı ile ilgili bilgileri loglamak için dahili olarak [debug](https://www.npmjs.com/package/debug) mödülünü kullanmaktadır.

<div class="doc-box doc-info" markdown="1">
`debug`, `console.log` metodunun uzatılmış bir sürümü gibidir, ama `console.log` metodunun aksine, üretim kodunda `debug` ifadelerini yorum satırına almak zorunda değilsiniz. Loglama varsayılan olarak devre dışı bırakılmıştır ve şarta bağlı olarak `DEBUG` ortam değişkeni kullanılarak devreye alınabilir.
</div>
Express uygulamasında kullanılan ütün dahili logları görmek için, uygulamanızı başlatırken `DEBUG` ortam değikenini `express:*` olarak güncelleyin.

```console
Expand Down Expand Up @@ -121,7 +116,3 @@ Node.js üzerinden koşulduğunda hata ayıklama loglamasının davranışını

__Not:__ `DEBUG_` ile başlayan ortam değişkenleri, `%o`/`%O` biçemleyicileriyle kullanılmak üzere bir Seçenekler nesnesine dönüştürülür.
Tam listeyi görmek için Node.js'in [`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options) dökümantasyonuna bakınız.

## Kaynaklar

`debug` ile ilgili daha fazla bilgi için bakınız [debug](https://www.npmjs.com/package/debug).
13 changes: 1 addition & 12 deletions uk/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ lang: uk

# Зневадження в Express

Express uses the [debug](https://www.npmjs.com/package/debug) module
internally to log information about route matches, middleware functions that are in use, application mode,
and the flow of the request-response cycle.

<div class="doc-box doc-info" markdown="1">
`debug` is like an augmented version of `console.log`, but unlike `console.log`, you don't have to
comment out `debug` logs in production code. Logging is turned off by default and can be conditionally turned on by using the `DEBUG` environment variable.
</div>

To see all the internal logs used in Express, set the `DEBUG` environment variable to
`express:*` when launching your app.

Expand Down Expand Up @@ -99,7 +90,7 @@ To see the logs only from the router implementation set the value of `DEBUG` to

## Applications generated by `express`

An application generated by the `express` command also uses the `debug` module and its debug namespace is scoped to the name of the application.
An application generated by the `express` command uses the `debug` module and its debug namespace is scoped to the name of the application.

For example, if you generated the app with `$ express sample-app`, you can enable the debug statements with the following command:

Expand All @@ -112,5 +103,3 @@ You can specify more than one debug namespace by assigning a comma-separated lis
```console
$ DEBUG=http,mail,express:* node index.js
```

For more information about `debug`, see the [debug](https://www.npmjs.com/package/debug).
13 changes: 1 addition & 12 deletions uz/guide/debugging.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,6 @@ lang: uz

# Debugging Express

Express uses the [debug](https://github.com/visionmedia/debug) module
internally to log information about route matches, middleware in use, application mode,
and the flow of the request-response cycle.

<div class="doc-box doc-info" markdown="1">
`debug` is like an augmented version of `console.log`. But unlike `console.log`, you don't have to
comment out `debug` logs in production code. It is turned off by default and can be conditionally turned on with the use an environment variable named `DEBUG`.
</div>

To see all the internal logs used in Express, simply set the `DEBUG` environment variable to
`express:*` when launching your app.

Expand Down Expand Up @@ -99,7 +90,7 @@ To see the logs only from the router implementation set the value of `DEBUG` to

## `express`-generated app

The app generated by the `express` command also uses the `debug` module and its debug namespace is scoped to the name of the application.
The app generated by the `express` command uses the `debug` module and its debug namespace is scoped to the name of the application.

If you generated the app with

Expand All @@ -118,5 +109,3 @@ You can specify more than one debug namespace by assignning a comma separated li
```console
$ DEBUG=http,mail,express:* node index.js
```

For more documentation on `debug`, see the [debug guide](https://github.com/visionmedia/debug).
Loading

0 comments on commit 22e1ae0

Please sign in to comment.