The std/node library

The std/node part of the Deno standard library is a Node.js compatibility layer. It’s primary focus is providing “polyfills” for Node.js’s built-in modules. It also provides a mechanism for loading CommonJS modules into Deno.

The library is most useful when trying to use your own or private code that was written for Node.js. If you are trying to consume public npm packages, you are likely to get a better result using a CDN.

Node.js built-in modules

The standard library provides several “replacement” modules for Node.js built-in modules. These either replicate the functionality of the built-in or they call the Deno native APIs, returning an interface that is compatible with Node.js.

The standard library provides modules for the the following built-ins:

In addition, there is the std/node/global.ts module which provides some of the Node.js globals like global, process, and Buffer.

If you want documentation for any of the modules, you can simply type deno doc and the URL of the module in your terminal:

  1. > deno doc https://deno.land/std/fs/move.ts

Loading CommonJS modules

Deno only supports natively loading ES Modules, but a lot of Node.js code is still written in the CommonJS format. As mentioned above, for public npm packages, it is often better to use a CDN to transpile CommonJS modules to ES Modules for consumption by Deno. Not only do you get reliable conversion plus all the dependency resolution and management without requiring a package manager to install the packages on your local machine, you get the advantages of being able to share your code easier without requiring other users to setup some of the Node.js infrastructure to consume your code with Node.js.

That being said, the built-in Node.js module "module" provides a function named createRequire() which allows you to create a Node.js compatible require() function which can be used to load CommonJS modules, as well as use the same resolution logic that Node.js uses when trying to load a module. createRequire() will also install the Node.js globals for you.

Example usage would look like this:

  1. import { createRequire } from "https://deno.land/std@$STD_VERSION/node/module.ts";
  2. // import.meta.url will be the location of "this" module (like `__filename` in
  3. // Node.js), and then serve as the root for your "package", where the
  4. // `package.json` is expected to be, and where the `node_modules` will be used
  5. // for resolution of packages.
  6. const require = createRequire(import.meta.url);
  7. // Loads the built-in module Deno "replacement":
  8. const path = require("path");
  9. // Loads a CommonJS module (without specifying the extension):
  10. const cjsModule = require("./my_mod");
  11. // Uses Node.js resolution in `node_modules` to load the package/module. The
  12. // package would need to be installed locally via a package management tool
  13. // like npm:
  14. const leftPad = require("left-pad");

When modules are loaded via the created require(), they are executed in a context which is similar to a Node.js context, which means that a lot of code written targeting Node.js will work.