From 22e1ae0e5c296f2999aaee2e6a11fde32bd7c4c5 Mon Sep 17 00:00:00 2001 From: Douglas Christopher Wilson Date: Fri, 29 Sep 2023 13:29:13 -0400 Subject: [PATCH] Remove reference to debug module in debugging guide closes #1442 --- de/guide/debugging.md | 11 ----------- en/guide/debugging.md | 15 +-------------- es/guide/debugging.md | 10 +--------- fr/guide/debugging.md | 13 +------------ it/guide/debugging.md | 11 ----------- ja/guide/debugging.md | 8 -------- ko/guide/debugging.md | 11 ----------- pt-br/guide/debugging.md | 15 --------------- ru/guide/debugging.md | 9 --------- sk/guide/debugging.md | 8 -------- th/guide/debugging.md | 13 +------------ tr/guide/debugging.md | 9 --------- uk/guide/debugging.md | 13 +------------ uz/guide/debugging.md | 13 +------------ zh-cn/guide/debugging.md | 8 -------- zh-tw/guide/debugging.md | 8 -------- 16 files changed, 6 insertions(+), 169 deletions(-) diff --git a/de/guide/debugging.md b/de/guide/debugging.md index 111e4f3e..b3bf3655 100755 --- a/de/guide/debugging.md +++ b/de/guide/debugging.md @@ -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. - -
-`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. -
- Wenn Sie alle in Express verwendeten internen Protokolle anzeigen wollen, legen Sie beim Starten Ihrer Anwendung die Umgebungsvariable `DEBUG` auf `express:*` fest. ```console @@ -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 @@ -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). diff --git a/en/guide/debugging.md b/en/guide/debugging.md index 5d6af2ce..0658512b 100755 --- a/en/guide/debugging.md +++ b/en/guide/debugging.md @@ -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. - -
-`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. -
- To see all the internal logs used in Express, set the `DEBUG` environment variable to `express:*` when launching your app. @@ -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: @@ -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). diff --git a/es/guide/debugging.md b/es/guide/debugging.md index 64329c0a..17c019a7 100755 --- a/es/guide/debugging.md +++ b/es/guide/debugging.md @@ -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. - -
-`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`. -
- Para ver todos los registros internos utilizados en Express, establezca la variable de entorno `DEBUG` en `express:*` cuando inicie la aplicación. ```console @@ -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: @@ -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). diff --git a/fr/guide/debugging.md b/fr/guide/debugging.md index 7f28a260..6a59a52e 100755 --- a/fr/guide/debugging.md +++ b/fr/guide/debugging.md @@ -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. - -
-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`. -
- 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 @@ -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 : @@ -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). diff --git a/it/guide/debugging.md b/it/guide/debugging.md index 50a3f5d8..e8ab0ab5 100755 --- a/it/guide/debugging.md +++ b/it/guide/debugging.md @@ -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. - -
-`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`. -
- Per visualizzare tutti i log interni utilizzati in Express, impostare la variabile di ambiente `DEBUG` su `express:*` quando si avvia l'applicazione. @@ -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). diff --git a/ja/guide/debugging.md b/ja/guide/debugging.md index 5510b7c9..9cc94e11 100755 --- a/ja/guide/debugging.md +++ b/ja/guide/debugging.md @@ -7,12 +7,6 @@ lang: ja # Express のデバッグ -Express は、[debug](https://www.npmjs.com/package/debug) モジュールを内部的に使用して、ルートの一致、使用中のミドルウェア関数、アプリケーション・モード、および要求と応答のサイクルのフローに関する情報をログに記録します。 - -
-`debug` は、`console.log` の拡張版のようなものですが、`console.log` とは異なり、実動コードで `debug` ログをコメント化する必要はありません。ロギングはデフォルトでオフになっており、`DEBUG` 環境変数を使用して条件付きでオンにすることができます。 -
- Express で使用されているすべての内部ログを表示するには、アプリケーションの起動時に `DEBUG` 環境変数を `express:*` に設定します。 ```console @@ -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) を参照してください。 diff --git a/ko/guide/debugging.md b/ko/guide/debugging.md index 16244f2a..f4455e41 100755 --- a/ko/guide/debugging.md +++ b/ko/guide/debugging.md @@ -7,15 +7,6 @@ lang: ko # Express 디버깅 -Express는 내부적으로 [debug](https://www.npmjs.com/package/debug) 모듈을 -사용하여 라우트 일치, 사용 중인 미들웨어 함수, 애플리케이션 모드, 그리고 요청-응답 주기의 -플로우에 대한 정보를 로그합니다. - -
-`debug`는 `console.log`의 보강된 버전과도 같지만, `console.log`와는 달리 -프로덕션 코드에서 `debug` 로그를 주석 처리할 필요가 없습니다. 로깅은 기본적으로 꺼져 있으며, `DEBUG` 환경 변수를 사용하여 조건부로 켤 수 있습니다. -
- Express에서 사용되는 모든 내부 로그를 확인하려면, 앱을 실행할 때 `DEBUG` 환경 변수를 `express:*`로 설정하십시오. @@ -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)를 참조하십시오. diff --git a/pt-br/guide/debugging.md b/pt-br/guide/debugging.md index 2b1ee848..bd3a8b08 100755 --- a/pt-br/guide/debugging.md +++ b/pt-br/guide/debugging.md @@ -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. - -
-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`. -
- Para ver todos os logs interno usados no Express, configure a variável de ambiente `DEBUG` para `express:*` ao ativar seu aplicativo. @@ -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). diff --git a/ru/guide/debugging.md b/ru/guide/debugging.md index 2cec6f26..c86c29a7 100755 --- a/ru/guide/debugging.md +++ b/ru/guide/debugging.md @@ -7,13 +7,6 @@ lang: ru # Отладка Express -В Express используется внутренний модуль [debug](https://www.npmjs.com/package/debug) для -регистрации информации о сопоставлениях маршрутов, используемых функциях промежуточной обработки, режиме приложения и выполнении цикла "запрос-ответ". - -
-`debug` можно сравнить с расширенной версией `console.log`, но, в отличие от `console.log`, в рабочем коде не нужно добавлять символы комментария к протоколам `debug`. Ведение протокола по умолчанию выключено, но его можно условно активировать с помощью среды переменной `DEBUG`. -
- Для просмотра всех внутренних протоколов, используемых в Express, при запуске приложения задайте для переменной среды `DEBUG` значение `express:*`. ```console @@ -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). diff --git a/sk/guide/debugging.md b/sk/guide/debugging.md index 1d94fa4b..a01382dd 100644 --- a/sk/guide/debugging.md +++ b/sk/guide/debugging.md @@ -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). - -
-`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. -
- Ak chcete vidieť všetky interné logy Express-u, nastavte pri spúštaní vašej aplikácie environment premennú `DEBUG` na hodnotu `express:*`. @@ -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). diff --git a/th/guide/debugging.md b/th/guide/debugging.md index c287fbc4..111ba652 100755 --- a/th/guide/debugging.md +++ b/th/guide/debugging.md @@ -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. - -
-`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. -
- To see all the internal logs used in Express, set the `DEBUG` environment variable to `express:*` when launching your app. @@ -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: @@ -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). diff --git a/tr/guide/debugging.md b/tr/guide/debugging.md index e8d4470c..f3220627 100644 --- a/tr/guide/debugging.md +++ b/tr/guide/debugging.md @@ -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. - -
-`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. -
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 @@ -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). diff --git a/uk/guide/debugging.md b/uk/guide/debugging.md index 26114716..7ea66bdd 100755 --- a/uk/guide/debugging.md +++ b/uk/guide/debugging.md @@ -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. - -
-`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. -
- To see all the internal logs used in Express, set the `DEBUG` environment variable to `express:*` when launching your app. @@ -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: @@ -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). diff --git a/uz/guide/debugging.md b/uz/guide/debugging.md index b55376dc..f30e13ba 100644 --- a/uz/guide/debugging.md +++ b/uz/guide/debugging.md @@ -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. - -
-`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`. -
- To see all the internal logs used in Express, simply set the `DEBUG` environment variable to `express:*` when launching your app. @@ -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 @@ -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). diff --git a/zh-cn/guide/debugging.md b/zh-cn/guide/debugging.md index 29c302b9..b84b6ddd 100755 --- a/zh-cn/guide/debugging.md +++ b/zh-cn/guide/debugging.md @@ -7,12 +7,6 @@ lang: zh-cn # 调试 Express -Express 在内部使用[调试](https://www.npmjs.com/package/debug)模块来记录关于路由匹配、使用的中间件函数、应用程序模式以及请求/响应循环流程的信息。 - -
-`debug` 就像是扩充版的 `console.log`,但是与 `console.log` 不同,您不必注释掉生产代码中的 `debug` 日志。缺省情况下,日志记录功能已关闭,可以使用 `DEBUG` 环境变量有条件地开启日志记录。 -
- 要查看 Express 中使用的所有内部日志,在启动应用程序时,请将 `DEBUG` 环境变量设置为 `express:*`。 ```console @@ -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)。 diff --git a/zh-tw/guide/debugging.md b/zh-tw/guide/debugging.md index 16e4b910..a7af511e 100755 --- a/zh-tw/guide/debugging.md +++ b/zh-tw/guide/debugging.md @@ -7,12 +7,6 @@ lang: zh-tw # 對 Express 除錯 -Express 在內部使用 [debug](https://www.npmjs.com/package/debug) 模組,來記載路由相符項、使用中的中介軟體函數、應用程式模式,以及要求/回應循環流程等相關資訊。 - -
-`debug` 像是 `console.log` 的擴增版本,但與 `console.log` 不同的是,您不必在正式作業程式碼中註銷 `debug` 日誌。依預設,會關閉記載,並且可以使用 `DEBUG` 環境變數有條件地開啟。 -
- 如果要查看 Express 中使用的所有內部日誌,在您啟動應用程式時,請將 `DEBUG` 環境變數設為 `express:*`。 ```console @@ -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)。