@types/node

What is @types/node?

The @types/node package contains TypeScript type definitions for Node.js. It provides TypeScript interfaces and types for Node.js modules, allowing developers to use TypeScript's static type checking with the Node.js runtime environment. This helps to catch errors at compile time and provides better editor support with features like auto-completion and inline documentation.

What are @types/node's main functionalities?

File System

Type definitions for the File System module allow developers to work with the file system using TypeScript, with methods for reading, writing, and manipulating the file system.

import * as fs from 'fs';

fs.readFile('/path/to/file', 'utf8', (err, data) => {
  if (err) throw err;
  console.log(data);
});

HTTP Server

Type definitions for the HTTP module enable developers to create HTTP servers and clients with TypeScript, handling requests and responses with proper type annotations.

import * as http from 'http';

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello World\n');
});

server.listen(3000);

Events

Type definitions for the Events module provide types for event handling, allowing developers to work with event emitters and listeners in a type-safe manner.

import { EventEmitter } from 'events';

const eventEmitter = new EventEmitter();

eventEmitter.on('myEvent', (arg) => {
  console.log(`Event fired with argument: ${arg}`);
});

eventEmitter.emit('myEvent', 'Hello Event!');

Streams

Type definitions for the Streams module help developers to work with Node.js streams, providing types for readable, writable, duplex, and transform streams.

import * as fs from 'fs';
import * as stream from 'stream';

const readStream = fs.createReadStream('/path/to/file');
const writeStream = fs.createWriteStream('/path/to/destination');

readStream.pipe(new stream.Transform({
  transform(chunk, encoding, callback) {
    // Transform the chunk to uppercase
    callback(null, chunk.toString().toUpperCase());
  }
})).pipe(writeStream);

Child Processes

Type definitions for the Child Processes module allow developers to spawn or execute new processes, providing types for handling the output and errors.

import { exec } from 'child_process';

exec('ls -lh /usr', (error, stdout, stderr) => {
  if (error) {
    console.error(`exec error: ${error}`);
    return;
  }
  console.log(`stdout: ${stdout}`);
  console.error(`stderr: ${stderr}`);
});

Other packages similar to @types/node

typescript

The TypeScript package is the core compiler for TypeScript. It provides the language services and type checking for TypeScript code but does not include type definitions for Node.js, which @types/node provides.

ts-node

ts-node is a TypeScript execution engine and REPL for Node.js. It allows you to run TypeScript files directly without pre-compiling them. It uses the TypeScript package for type checking but relies on @types/node for Node.js type definitions.

tslib

tslib is a runtime library for TypeScript that includes helper functions used by TypeScript emitted code. It does not provide type definitions but is often used alongside @types/node in TypeScript projects to reduce code duplication.

README

Installation

npm install --save @types/node

Summary

This package contains type definitions for Node.js ( http://nodejs.org/ ).

Details

Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node

Additional Details

• Last updated: Tue, 26 Mar 2019 20:23:36 GMT
• Dependencies: none
• Global values: Buffer, NodeJS, Symbol, __dirname, __filename, clearImmediate, clearInterval, clearTimeout, console, exports, global, module, process, queueMicrotask, require, setImmediate, setInterval, setTimeout

Credits

These definitions were written by Microsoft TypeScript https://github.com/Microsoft, DefinitelyTyped https://github.com/DefinitelyTyped, Alberto Schiabel https://github.com/jkomyno, Alexander T. https://github.com/a-tarasyuk, Alvis HT Tang https://github.com/alvis, Andrew Makarov https://github.com/r3nya, Benjamin Toueg https://github.com/btoueg, Bruno Scheufler https://github.com/brunoscheufler, Chigozirim C. https://github.com/smac89, Christian Vaagland Tellnes https://github.com/tellnes, David Junger https://github.com/touffy, Deividas Bakanas https://github.com/DeividasBakanas, Eugene Y. Q. Shen https://github.com/eyqs, Flarna https://github.com/Flarna, Hannes Magnusson https://github.com/Hannes-Magnusson-CK, Hoàng Văn Khải https://github.com/KSXGitHub, Huw https://github.com/hoo29, Kelvin Jin https://github.com/kjin, Klaus Meinhardt https://github.com/ajafff, Lishude https://github.com/islishude, Mariusz Wiktorczyk https://github.com/mwiktorczyk, Matthieu Sieben https://github.com/matthieusieben, Mohsen Azimi https://github.com/mohsen1, Nicolas Even https://github.com/n-e, Nicolas Voigt https://github.com/octo-sniffle, Parambir Singh https://github.com/parambirs, Sebastian Silbermann https://github.com/eps1lon, Simon Schick https://github.com/SimonSchick, Thomas den Hollander https://github.com/ThomasdenH, Wilco Bakker https://github.com/WilcoBakker, wwwy3y3 https://github.com/wwwy3y3, Zane Hannan AU https://github.com/ZaneHannanAU, Jeremie Rodriguez https://github.com/jeremiergz, Samuel Ainsworth https://github.com/samuela, Kyle Uehlein https://github.com/kuehlein, Jordi Oliveras Rovira https://github.com/j-oliveras, Thanik Bhongbhibhat https://github.com/bhongy.