re:re:actable
Урок 052 минуты чтения

Что такое встроенные модули Node.js?

На этой странице
Кратко

Встроенные модули Node.js - это модули стандартной библиотеки, которые доступны без установки из npm: node:fs, node:path, node:http, node:stream, node:crypto и другие.

Вопрос

Что такое встроенные модули Node.js и зачем импортировать их с префиксом node:?

Главное

Встроенный модуль можно импортировать сразу.

import { readFile } from "node:fs/promises";
 
const text = await readFile("README.md", "utf8");

Префикс node: явно показывает, что модуль встроенный.

Частые встроенные модули

МодульДля чего нужен
node:fsФайловая система
node:pathРабота с путями
node:httpHTTP-серверы и клиенты
node:eventsEventEmitter
node:streamПотоки данных
node:cryptoХеши, случайные значения, криптография
node:processИнформация о процессе
node:worker_threadsПараллельные вычисления
node:testВстроенный test runner

CommonJS пример

const path = require("node:path");
 
const filePath = path.join("src", "index.js");

Почему node: полезен

import fs from "node:fs";

Такой импорт нельзя перепутать с npm-пакетом с похожим именем. Это делает код читаемее и безопаснее.

Что важно помнить

  • Встроенные модули не устанавливаются из npm: fs, path, http, crypto, events, stream, os.
  • Префикс node: явно указывает на встроенный модуль и защищает от подмены пакетом с тем же именем.
  • Некоторые модули доступны только с префиксом: node:test, node:sqlite.
  • Многие модули имеют promise-версии: node:fs/promises, node:timers/promises, node:dns/promises.

Мини-шпаргалка

  • Встроенные модули не нужно устанавливать.
  • Лучше импортировать их с префиксом node:.
  • fs работает с файлами.
  • path строит пути.
  • http позволяет создать сервер.
  • stream, events, crypto, process часто встречаются в backend-коде.

Документация

Node.js API documentation, Node.js: Built-in modules.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам