esm-resolve

Resolves ESM imports in JS

Usage no npm install needed!

<script type="module">
  import esmResolve from 'https://cdn.skypack.dev/esm-resolve';
</script>

README

Tests

An ESM import resolver for Node written in pure JS. This is written to be part of an ESM dev server or build process, as Node's import process is impossible to introspect. It also allows some cases which would otherwise be failures.

Usage

Install and import "esm-resolve" via your favourite package manager. Create a resolver based on the importing file.

import buildResolver from 'esm-resolve';

const r = buildResolver('./path/to/js/file.js');

r('./relative');             // e.g., './relative.js'
r('foo-test-package-name');  // e.g., './node_modules/foo-test-package-name/index.js'

Resolution logic is actually the same for any files in the same directory, so resolver objects can be reused (and they have a small bit of cache).

Notes

This implements modern Node resolution, i.e., subpath exports and conditional exports. By default, it will rewrite to the "browser", "import" or "default" keys (not "node", as this is for your browser).

It fails gracefully in many ways, including falling back to real paths if exports aren't defined. It will also remove imports that point purely to ".d.ts" files (you don't need to create peer JS).

You can set these options via the resolver's second argument.