Informazioni su questa documentazione
Benvenuti alla documentazione di riferimento ufficiale delle API per Node.js!
Node.js è un runtime JavaScript costruito sul motore JavaScript V8.
Contribuire
Segnala gli errori in questa documentazione nel tracker dei problemi. Consulta la guida per i contributi per le istruzioni su come inviare 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, oppure 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 di versionamento semantico. Modifiche o rimozioni non retrocompatibili possono verificarsi in qualsiasi versione futura. L'uso della funzionalità non è raccomandato in ambienti di produzione.
[Stabile: 2 - Stabile]
Stabile: 2 Stabilità: 2 - Stabile. La compatibilità con l'ecosistema npm è una priorità alta.
[Stabile: 3 - Legacy]
Stabile: 3 Stabilità: 3 - Legacy. Sebbene sia improbabile che questa funzionalità venga rimossa e sia comunque coperta dalle garanzie di versionamento semantico, non è più attivamente mantenuta e sono disponibili altre alternative.
Le funzionalità sono contrassegnate come legacy piuttosto che come obsolete se il loro utilizzo non causa danni e sono ampiamente utilizzate all'interno dell'ecosistema npm. È improbabile che i bug trovati nelle funzionalità legacy vengano corretti.
Prestare attenzione quando si utilizzano funzionalità sperimentali, in particolare quando si creano librerie. Gli utenti potrebbero non essere consapevoli che vengono utilizzate funzionalità sperimentali. Bug o modifiche al comportamento possono sorprendere gli utenti quando si verificano modifiche alle API sperimentali. Per evitare sorprese, l'uso di una funzionalità sperimentale potrebbe richiedere un flag da riga di comando. Le funzionalità sperimentali possono anche emettere un avviso.
Panoramica sulla stabilità
| API | Stabilità |
|---|---|
| Assert | (2) Stabile |
| Hook asincroni | (1) Sperimentale |
| Tracciamento 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 |
| Domain | (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 |
| String decoder | (2) Stabile |
| Test runner | (2) Stabile |
| Timers | (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 di JavaScript) | (2) Stabile |
| Web Crypto API | (2) Stabile |
| Web Streams API | (2) Stabile |
| Interfaccia di sistema WebAssembly (WASI) | (1) Sperimentale |
| Thread di Worker | (2) Stabile |
| Zlib | (2) Stabile |
Output JSON
Aggiunto in: v0.6.12
Ogni documento .html ha un corrispondente documento .json. Questo è per IDE e altre utilità che consumano la documentazione.
Chiamate di sistema e pagine man
Le funzioni di Node.js che avvolgono una chiamata di sistema lo documenteranno. La documentazione rimanda alle corrispondenti pagine man che descrivono come funziona la chiamata di sistema.
La maggior parte delle chiamate di sistema Unix hanno analoghi in Windows. Tuttavia, differenze di comportamento possono essere inevitabili.