Interoperating with Node and NPM

    There are some foundational things to understand about differences between Node and Deno that can help in understanding what challenges might be faced:

    • Current Node supports both CommonJS and ES Modules, while Deno only supports ES Modules. The addition of stabilized ES Modules in Node is relatively recent and most code written for Node is in the CommonJS format.
    • Node has quite a few built-in modules that can be imported and they are a fairly expansive set of APIs. On the other hand, Deno focuses on implementing web standards, and where functionality goes beyond the browser, we locate APIs in a single global variable/namespace. Lots of code written for Node expects/depends upon these built-in APIs to be available.
    • Node has a non-standards based module resolution algorithm, where you can import bare-specifiers (e.g. react or lodash) and Node will look in your local and global node_modules for a path, introspect the and try to see if there is a module named the right way. Deno resolves modules the same way a browser does. For local files, Deno expects a full module name, including the extension. When dealing with remote imports, Deno expects the web server to do any “resolving” and provide back the media type of the code (see the Determining the type of file for more information).
    • Node doesn’t support remote HTTP imports. It expects all 3rd party code to be installed locally on your machine using a package manager like npm into the local or global node_modules folder. Deno supports remote HTTP imports (as well as and blob URLs) and will go ahead and fetch the remote code and cache it locally, similar to the way a browser works.
    • Using the modules of the Deno standard library to “polyfill” the built-in modules of Node
    • Using CDNs to access the vast majority of npm packages in ways that work under Deno.
    • And finally, a general section of

    That being said, some differences cannot be overcome:

    • Node has a plugin system that is incompatible with Deno, and Deno will never support Node plugins. If the Node code you want to use requires a “native” Node plugin, it won’t work under Deno.
    • Node has some built-in modules (e.g. like vm) that are effectively incompatible with the scope of Deno and therefore there aren’t easy ways to provide a polyfill of the functionality in Deno.