Skip to content

Índice de estabilidad en node.js

22 septiembre, 2022

A lo largo de la documentación, hay indicaciones de la estabilidad de una sección. En este sentido, algunas API están tan probadas y son tan confiables que es poco probable que alguna vez cambien. Por su parte, otros son nuevos y experimentales, o se sabe que son peligrosos. En este artículo se tomará en cuenta el índice de estabilidad en node.js junto con los aspectos relacionados con este.

El índice de estabilidad en node.js comprende las siguientes estabilidades:

  • Estabilidad: 0 – Obsoleto. La característica puede emitir advertencias. En tal sentido, no se garantiza la compatibilidad con versiones anteriores
  • Estabilidad: 1 – Experimental. La característica no está sujeta a reglas de control de versiones semánticas. Por su lado, es posible que se produzcan cambios o eliminaciones no compatibles con versiones anteriores en cualquier versión futura. Asimismo, no se recomienda el uso de la función en entornos de producción
  • Estabilidad: 2 – Estable. La compatibilidad con el ecosistema NPM es una alta prioridad
  • Estabilidad: 3 – Legado. Aunque es poco probable que esta característica se elimine y todavía está cubierta por las garantías de control de versiones semánticas, ya no se mantiene activamente y hay otras alternativas disponibles.

Las características se marcan como heredadas en lugar de estar obsoletas si su uso no causa daño y se confía ampliamente en ellas dentro del ecosistema NPM. A su vez, es poco probable que se corrijan los errores encontrados en las funciones heredadas.

Desde luego, tenga cuidado al utilizar funciones experimentales, especialmente dentro de los módulos. Esto ya que es posible que los usuarios no sepan que se están utilizando funciones experimentales. Así, los errores o cambios de comportamiento pueden sorprender a los usuarios cuando se producen modificaciones en la API experimental.

Para evitar sorpresas, el uso de una función Experimental puede necesitar un indicador de línea de comandos. Las características experimentales también pueden emitir una advertencia.

Resumen de estabilidad

API Estabilidad
afirmar (2) estable
ganchos_async (1) experimental
seguimiento_de_contexto_asincrónico (2) estable
buffer (2) estable
niño_proceso (2) estable
grupo (2) estable
consola (2) estable
cripto (2) estable
dgrama (2) estable
canal_diagnóstico (1) experimental
DNS (2) estable
dominio (0) Obsoleto
fs (2) estable
http (2) estable
http/2 (2) estable
https (2) estable
inspector (2) estable
módulo (2) estable
sistema operativo (2) estable
sendero (2) estable
performance_measurement_apis (2) estable
punycode (0) Obsoleto
cadena de consulta (3) Legado
línea de lectura (2) estable
reemplazar (2) estable
corriente (2) estable
decodificador_de_cadenas (2) estable
corredor_de_prueba (1) experimental
temporizadores (2) estable
tls_(ssl) (2) estable
eventos_de_rastreo (1) experimental
tty (2) estable
URL (2) estable
útil (2) estable
máquina virtual (2) estable
web_crypto_api (1) experimental
web_streams_api (1) experimental
webassembly_system_interface_(wasi) (1) experimental
subprocesos_trabajadores (2) estable
zlib (2) estable
Puedes leer también:  Mocha y Jest: Cómo Elegir el Framework de Pruebas Adecuado para JavaScript

Salida .JSON

Por cuenta propia, cada documento .html tiene un documento .json correspondiente. Por supuesto, esto es para IDE y otras utilidades que consumen la documentación.

Llamadas al sistema y páginas de manual

A su vez, las funciones de Node.js que envuelven una llamada al sistema lo documentarán. Por otra parte, los documentos se vinculan a las páginas de manual correspondientes que describen cómo funciona la llamada al sistema.

La mayoría de las llamadas al sistema Unix tienen análogos de Windows. Aun así, las diferencias de comportamiento pueden ser inevitables.

Uso y ejemplo

Uso

node [options] [V8 options] [script.js | -e "script" | - ] [arguments]

Por asegurar, consulte el documento de opciones de la línea de comandos para obtener más información.

Ejemplo

En particular, un ejemplo de un servidor web escrito con Node.js que responde con ‘Hello, World!’:

Al respecto, los comandos en este documento comienzan con $o > para replicar cómo aparecerían en la terminal de un usuario. Desde luego, no incluya los caracteres $y >. Estos están allí para mostrar el inicio de cada comando.

Al mismo tiempo, las líneas que no comienzan con $o >carácter muestran la salida del comando anterior.

Primero, asegúrese de haber descargado e instalado Node.js. Luego, consulte Instalación de Node.js a través del administrador de paquetes para obtener más información sobre la instalación.

Ahora, cree una carpeta de proyecto vacía llamada projects y luego navegue hasta ella.

Linux y Mac:

$ mkdir ~/projects$ cd ~/projects
CMD de Windows:
> mkdir %USERPROFILE%\projects> cd %USERPROFILE%\projects
Windows PowerShell:
> mkdir $env:USERPROFILE\projects> cd $env:USERPROFILE\projects

A continuación, cree un nuevo archivo de origen en la carpeta projects y llámelo hello-world.js.

Posteriormente, abra hello-world.jsen cualquier editor de texto preferido y pegue el siguiente contenido:

const http = require(‘node:http’); const hostname = ‘127.0.0.1’;const port = 3000; const server = http.createServer((req, res) => {  res.statusCode = 200;  res.setHeader(‘Content-Type’, ‘text/plain’);  res.end(‘Hello, World!\n’);}); server.listen(port, hostname, () => {  console.log(`Server running at http://${hostname}:${port}/`);});

Luego, guarde el archivo, vuelva a la ventana del terminal e ingrese el siguiente comando:

$ node hello-world.js

Después, una salida como esta debería aparecer en la terminal:

Server running at http://127.0.0.1:3000/

Por último, abra cualquier navegador web preferido y visite http://127.0.0.1:3000.

Si el navegador muestra la cadena Hello, World!, eso indica que el servidor está funcionando.

https://aprendeinformaticas.com/

https://nodejs.org/dist/latest-v16.x/docs/api/documentation.html