Informazioni su questa documentazione
Benvenuti alla documentazione di riferimento ufficiale dell'API per Node.js!
Node.js è un runtime JavaScript basato sul motore JavaScript V8.
Contribuire
Segnalare errori in questa documentazione nel tracker dei problemi. Consultare la guida per i contributi per le indicazioni su come inviare le pull request.
Indice di stabilità
In tutta la documentazione sono presenti indicazioni sulla stabilità di una sezione. Alcune API sono così collaudate e affidabili che è improbabile che cambino mai. Altre sono nuovissime e sperimentali, o note per essere pericolose.
Gli indici di stabilità sono i seguenti:
[Stabile: 0 - Obsoleto]
Stabile: 0 Stabilità: 0 - Obsoleto. La funzionalità potrebbe emettere avvisi. La compatibilità con le versioni precedenti non è garantita.
[Stabile: 1 - Sperimentale]
Stabile: 1 Stabilità: 1 - Sperimentale. La funzionalità non è soggetta alle regole del versioning semantico. Modifiche non compatibili con le versioni precedenti o la rimozione possono verificarsi in qualsiasi versione futura. L'utilizzo della funzionalità non è raccomandato negli ambienti di produzione.
[Stabile: 2 - Stabile]
Stabile: 2 Stabilità: 2 - Stabile. La compatibilità con l'ecosistema npm è una priorità elevata.
[Stabile: 3 - Legacy]
Stabile: 3 Stabilità: 3 - Legacy. Sebbene sia improbabile che questa funzionalità venga rimossa e sia ancora coperta dalle garanzie del versioning semantico, non è più attivamente gestita e sono disponibili altre alternative.
Le funzionalità sono contrassegnate come legacy anziché obsolete se il loro utilizzo non causa danni e sono ampiamente utilizzate nell'ecosistema npm. È improbabile che i bug trovati nelle funzionalità legacy vengano corretti.
Prestare attenzione quando si utilizzano le funzionalità sperimentali, in particolare quando si creano librerie. Gli utenti potrebbero non essere consapevoli dell'utilizzo di funzionalità sperimentali. Bug o modifiche di comportamento potrebbero sorprendere gli utenti quando si verificano modifiche all'API sperimentale. Per evitare sorprese, l'utilizzo di una funzionalità sperimentale potrebbe richiedere un flag della riga di comando. Le funzionalità sperimentali possono anche emettere un avviso.
Panoramica della stabilità
| API | Stabilità |
|---|---|
| Assert | (2) Stabile |
| Async hooks | (1) Sperimentale |
| Rilevamento del contesto asincrono | (2) Stabile |
| Buffer | (2) Stabile |
| Processo figlio | (2) Stabile |
| Cluster | (2) Stabile |
| Console | (2) Stabile |
| Crypto | (2) Stabile |
| Canale di diagnostica | (2) Stabile |
| DNS | (2) Stabile |
| Dominio | (0) Obsoleto |
| File system | (2) Stabile |
| HTTP | (2) Stabile |
| HTTP/2 | (2) Stabile |
| HTTPS | (2) Stabile |
| Inspector | (2) Stabile |
Moduli: API node:module | (1) .2 - Release candidate (versione asincrona) Stabilità: 1.1 - Sviluppo attivo (versione sincrona) |
| Moduli: moduli CommonJS | (2) Stabile |
| Moduli: TypeScript | (1) .1 - Sviluppo attivo |
| OS | (2) Stabile |
| Path | (2) Stabile |
| API di misurazione delle prestazioni | (2) Stabile |
| Punycode | (0) Obsoleto |
| Stringa di query | (2) Stabile |
| Readline | (2) Stabile |
| REPL | (2) Stabile |
| Applicazioni eseguibili singole | (1) .1 - Sviluppo attivo |
| SQLite | (1) .1 - Sviluppo attivo. |
| Stream | (2) Stabile |
| Decodificatore di stringhe | (2) Stabile |
| Test runner | (2) Stabile |
| Timer | (2) Stabile |
| TLS (SSL) | (2) Stabile |
| Eventi di traccia | (1) Sperimentale |
| TTY | (2) Stabile |
| Socket UDP/datagram | (2) Stabile |
| URL | (2) Stabile |
| Util | (2) Stabile |
| VM (esecuzione JavaScript) | (2) Stabile |
| Web Crypto API | (2) Stabile |
| Web Streams API | (2) Stabile |
| Interfaccia di sistema WebAssembly (WASI) | (1) Sperimentale |
| Thread worker | (2) Stabile |
| Zlib | (2) Stabile |
Output JSON
Aggiunto in: v0.6.12
Ogni documento .html ha un documento .json corrispondente. Questo è per IDE e altre utilità che consumano la documentazione.
Chiamate di sistema e pagine man
Le funzioni di Node.js che wrappano una chiamata di sistema lo documenteranno. La documentazione linka alle pagine man corrispondenti che descrivono come funziona la chiamata di sistema.
La maggior parte delle chiamate di sistema Unix hanno analoghi Windows. Tuttavia, differenze di comportamento potrebbero essere inevitabili.