Learning to debug applications in Node.js

Este es un práctico tutorial de cómo depurar tus aplicaciones hechas en Node.js. Con esto aprenderás a hacer esta tarea por completo y de la mejor manera. Esta guía lo ayudará a comenzar a depurar tus aplicaciones y scriptsConcepto de Scripts¿Qué son los Scripts?Los Scripts son fragmentos de código que se usan para dar forma a herramientas tanto en Internet como en el sector de la informática en general. Son una parte crucial del software, puesto que se trata exactamente del código que conforma a una aplicación en su totalidad o a una de sus funciones, como además el que puedes hallar explorando cómo está hecha una web.Desde plus Node.js. Continúa leyendo y entérate de mas.

Enable an inspector

When started with the switch --inspect , a Node.js process listens through WebSockets for diagnostic commands defined by the Inspector protocol by default on the host and port 127.0.0.1:9229. Each process is also assigned a unique UUID (for example 0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e).

Los clientes de Inspector deben conocer y especificar la dirección de host, el puerto y el UUID para conectarse a la interfaz de WebSocket. La UrlEl URL (Localizador Uniforme de Recursos), es una dirección definida que apunta a la posición de un archivo en un servidor y lo recupera. Las URL se introducen en un navegador web para ingresar a documentos en la web o se incrustan como hipervínculos dentro de un documento. Se puede usar un Permalink para que una URL esté disponible de forma permanente. Componentes de una URL • prefijo de protocolo plus complete ws://127.0.0.1:9229/0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e it depends of course on the actual host and port and on the correct UUID for the instance.

El Inspector también incluye un punto final HTTPEl HTTP (Hyper Text Transfer Protocol) es un protocolo que se usa para transmitir datos en redes. HTTP es un estándar técnico generalmente aceptado que establece cómo un cliente web se comunica con un servidor para que los datos solicitados por el cliente puedan ser cargados y mostrados. Información general Junto con el URL y el HTML, HTTP es uno de los conceptos más importantes de Internet (www). Fue desarrollado plus para servir metadataLos metadatos son datos estructurados que contienen información sobre una fuente como, por ejemplo, un libro o un documento web. Gracias a los metadatos resulta mucho más fácil hallar la fuente de información dado que contienen datos sobre el título, el autor, la fecha de publicación, la descripción, etc. Se utilizan en librerías pero además para la estadística y la ingeniería de software. Metadatos en WWW Los metadatos se utilizan plus sobre el depurador, incluida su URL de WebSocket, UUID y la URL de Chrome DevTools. Obtén estos metadatos enviando una solicitud HTTP a http: // [host: port] / json / list. This returns a JSON object like the following; use the webSocketDebuggerUrl property as the URL to connect directly to the Inspector.

{"description": "node.js instance", "devtoolsFrontendUrl": "chrome-devtools: //devtools/bundled/inspector.html? experiments = true & v8only = true & ws = 127.0.0.1: 9229 / 0f2c936f-b1cd-4ac9-aab3 -f63b0f33d55e "," faviconUrl ":" https://nodejs.org/static/favicon.ico "," id ":" 0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e "," title ":" node "," type ":" node "," url ":" file: // "," webSocketDebuggerUrl ":" ws: //127.0.0.1: 9229 / 0f2c936f-b1cd-4ac9-aab3-f63b0f33d55e "}

You can also instruct a started Node.js process without –inspect to start listening to debug messages by signaling it with SIGUSR1 (en Linux y OS X). A partir del Node 7, esto activa la APIConcepto de API¿Qué es una API?Una API, siglas de Application Programming Interface o Interfaz de Programación de Apps, es un recopilatorio de código que se puede emplear para que varias apps se comuniquen entre ellas. Es algo que realiza una tarea equivalente a la interfaz de usuario al momento de promover la interacción entre persona y programa, solo que aplicado única y exclusivamente dentro del entorno del software.Aún cuando suene plus de depuración heredada; en el Node 8 y posterior activará la API Inspector.

Security is involved

Since the debugger has full access to the Node.js runtime, a malicious actor capable of connecting to this port can execute arbitrary code on behalf of the node process. It is important to understand the security implications of exposing the debug port on public and private networks.

Exposing the debug port publicly is not safe

Si el depurador está vinculado a una IP adressDirección de Protocolo de Internet, la dirección IP es una dirección de red que se puede asignar a un dispositivo en una red sólo una vez. Esto hace falta para que los paquetes de datos puedan direccionarse y entregarse correctamente. Una dirección IP es el identificador único de un PC que establece su ubicación en Internet. Muestra qué proveedor se está usando. La dirección IP de 32 bits (además llamada plus pública, o 0.0.0.0, any client that can access your IP address will be able to connect to the debugger without any restrictions and will be able to execute arbitrary code.

By default node –inspect is bound to 127.0.0.1. You must explicitly provide a public IP address or 0.0.0.0, etc., if you want to allow external connections to the debugger. Doing so can expose you to a potentially significant security threat. We suggest that you secure proper firewalls and access controls to avoid a security exposure.

Local applications have full access to the inspector.

Even if you bind the inspector port to 127.0.0.1 (the default), any application running locally on your PC will have unrestricted access. This is by design to allow local debuggers to conveniently attach.

BrowsersConcepto de Navegadores¿Qué son los Navegadores?Los Navegadores son herramientas informáticas que utilizamos para, normalmente, navegar por Internet y visitar cualquier página web, al mismo tiempo de para hacer otras tareas como ver documentos, observar vídeos o reproducir contenido multimedia de cualquier tipo. Son un tipo de software sencillamente usual y bastante utilizado hoy en día.Insistimos en que es algo que se utiliza con mucha frecuencia, puesto que moverse por Internet plus, websockets y política del mismo origen.

Los sitios web abiertos en un browserUn navegador (además: browser) es una herramienta informática que te permite ver documentos y datos y navegar por la red. Los navegadores pueden mostrar distintos tipos de recursos de información; principalmente documentos HTML, a pesar de todo, además son posibles otros tipos de archivos y contenido multimedia, como PDF, JPEG, MPEG, GIF o el lenguaje de meta marcado. A través el uso de complementos especiales y la configuración respectivo, los plus web pueden hacer solicitudes WebSocket y HTTP bajo el modelo de seguridad del navegador. Es necesaria una conexión HTTP inicial para obtener un Id de sesiónUn ID de sesión es un número de identificación que se genera en el lado del servidor para asignar peticiones de usuario a una sesión. Este ID se almacena localmente con el usuario y se transfiere en forma de cookies o como un atributo URI (Uniform Resource Identifier). Cómo funciona Se puede ingresar a los datos de la última sesión que se almacena en el lado del servidor usando el plus de depurador único. La misma política de origen impide que los sitios web puedan realizar esta conexión HTTP.

Para mayor seguridad contra los ataques de reencuadernación de DNSConcepto de DNS¿Qué son las DNS (Domain Name Server)?Al hablar de DNS, nos referimos a las iniciales Domain Name System (Sistema de Nombres de Dominio). Consiste en una tecnología que recurre a las bases de datos para detectar la dirección IP a la que pertenece cualquier dominio que un usuario quiera desear. Es decir, toma la URL y la “traduce” para ofrecer como resultado su dirección exacta, su IP.Para quien plus, Node.js verifica que las cabeceras del ‘Host’ para la conexión especifiquen una dirección IP o localhost o localhost6 con precisión.

Estas políticas de seguridad no permiten conectarse a un serverLos servidores son ordenadores centrales y potentes dentro del campo de la tecnología de la información que procesan y proporcionan software y archivos en una red. Desde el punto de vista de un cliente, varios ordenadores en una red pueden ponerse en contacto con el servidor central para conseguir la información solicitada. En la arquitectura cliente-servidor, el servidor puede ser un software que proporciona un servicio y se ejecuta en plus de depuración remoto especificando el nombre del host. Puedes evitar esta restricción especificando la dirección IP o utilizando túneles ssh como se describe a continuación.

Inspector Clients

Varias herramientas comerciales y de Open SourceEl Código Abierto u Open Source se refiere al código fuente del software que es abiertamente alcanzable y que puede ser cambiado y distribuido por cualquier persona. La propuesta de código abierto estipula diez requerimientos para las licencias de software de código abierto. El principio El código fuente de un software se hace público: cualquiera puede leerlo, desarrollar el propio software y copiarlo. El software puede ser utilizado o distribuido plus pueden conectarse al Inspector de nodos. A continuación se ofrece información básica sobre estos temas:

• node-inspect
  • CLI debugger supported by the Node.js Foundation that uses the Inspector Protocol.
  • One version is included with Node and can be used with the inspect myscript.js node.
  • The latest version can also be installed standalone (for example, npm install -g node-inspect) and used with node-inspect myscript.js.
• Chrome DevTools 55+
  • Option 1: Open chrome: // inspect in a Chromium-based browser. Click the Configure button and make sure the destination host and port are listed.
  • Option 2: Copy devtoolsFrontendUrl from the output of / json / list (see above) or the –inspect hint text and paste it into Chrome.
  • Opción 3: Instale Chrome Extension NIM (Administrador del Inspector de Nodos): httpsHTTPS (protocolo de Transferencia de Hiper-Texto) es un protocolo que permite determinar una conexión segura entre el servidor y el cliente, que no puede ser interceptada por personas no autorizadas. En resumidas cuentas, es la versión segura de el http (Hyper Text Transfer Protocol) Cómo funciona Una conexión HTTP estándar en Internet puede ser fácilmente secuestrada por partes no autorizadas. El propósito de una conexión HTTPS es evitar esto: encriptar plus://chrome.google.com/webstore/detail/nim-node-inspector-manage/gnhhdgbaldcilmgcpfddgdbkhjohddkj
• Visual Studio Code 1.10+
  • In the debugging panel, click the settings icon to open .vscode / launch.json. Select "Node.js" for initial configuration.
• Visual Studio 2017
  • Choose "Debug> Start Debugging" from the menu or press F5.
• JetBrains WebStorm 2017.1+ and other JetBrains IDEs
  • Create a new Node.js debug configuration and click Debug. –Inspect will be used by default for Node.js 7+. To disable js.debugger.node.use.inspect in the IDE Registry.
• Chrome remote interface
  • Has a library to facilitate connections to Inspector protocol endpoints

Command line options

The following table lists the impact of various runtime flags on debugging:

1. –Inspect:
   • Enable inspection agent
   • Listen on the default address and port (127.0.0.0.1: 9229)
2. –Inspect = [host: port]:
   • Enable inspection agent
   • Bind to hostname address or host (default: 127.0.0.0.1)
   • Listen on port (default: 9229)
3. –Inspect-brk
   • Enable inspection agent
   • Listen on the default address and port (127.0.0.1:9229)
   • Pause before user code starts
4. –Inspect-brk =[host: port]
   • Enable inspection agent
   • Bind to hostname address or host (default: 127.0.0.0.1)
   • Listen on port (default: 9229)
   • Pause before user code starts
5. node inspect script.js
   • Spawn child process to run user script under –inspect flag; and use the main process to run the CLI debugger.
6. node inspect –port = xxxx script.js
   • Spawn child process to run user script under –inspect flag; and use the main process to run the CLI debugger.
   • Listen on port (default: 9229)

Enabling remote debugging scenarios

I recommend that you never make the debugger listen on a public IP address. If you need to allow remote debugging connections, I recommend using ssh tunnels instead. I am providing the following example for illustrative purposes only. Please understand the security risk of allowing remote access to a privileged service before proceeding.

Suppose you are running Node.js on a remote machine, remote.example.com, you want to be able to debug. On that machine, you should start the node process with the inspector listening only to localhost (the default).

$ node --inspect server.js [php] Now, on your local machine from where you want to start a debug client connection, you can configure an ssh tunnel: [php] $ ssh -L 9221: localhost: 9229 @ user_sample. remote.com

This starts an ssh tunnel session where a connection to port 9221 of your local machine will be forwarded to port 9229 of remote.example.com. Now you can attach a debugger like Chrome DevTools or Visual Studio Code to localhost: 9221, which should be able to debug as if the Node.js application was running locally.