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 |
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
