is-file-esm

Determines whether a Node file is a Module (import) or a Script (require)

Algorithm

Determining the module system of a file comes from three inputs, the type field of the closest package.json to that file, the file extension (.js, .mjs or .cjs) and the lesser know --input-type command-line flag. The latter only applies to dyamic input (via STDIN, --eval or --print flags) so is not considered with this library.

So to determine whether a file is an esm file (e.g. native EcmaScript modules) or not, we use the following procedure:

read package.json for "type" field,
  if type is "module"
    if answer.mjs -> module 
    if answer.js -> module
    if answer.cjs -> script
  if type is "commonjs"
    if answer.mjs -> module   
    if answer.js -> script
    if answer.cjs -> script
  if type is not set
    if answer.mjs -> module
    if answer.js -> script
    if answer.cjs -> script

API

The is-file-esm module provides synchronous, awaitable (promise-based) and callback based APIs.

In each case the Result object has the following shape:

1{
2  esm: Boolean, // true if file is a Module, false if it is a Script
3  type: String,  // the determined package.json type, may be undefined, 'module', or 'commonjs'
4  extType: String, // the file extension type, may be 'c', 'm' or 'j'
5  path: String,  // the input path
6  pkgPath: String // the path to the package.json from which the type was determined
7}

Awaitable (promise-based)

await isFileEsm(path) => Result

1  import isFileEsm from 'is-file-esm'
2  const { esm, path } = await isFileEsm('/path/to/file.js')
3  if (esm) console.log(`File ${path} is a Module`)
4  else console.log(`File ${path} is a Script`)

Callback-style

isFileEsm(path, cb(err, Result))

1  const isFileEsm = require('is-file-esm')
2  isFileEsm('/path/to/file.js', (err,  result) => {
3    if (err) {
4      console.error(err)
5      return
6    }
7    if (result.esm) console.log(`File ${result.path} is a Module`)
8    else console.log(`File ${result.path} is a Script`)
9  })

Synchronous

isFileEsm.sync(path) => Result

1  import isFileEsm from 'is-file-esm'
2  const { esm, path } = isFileEsm.sync('/path/to/file.js')
3  if (esm) console.log(`File ${path} is a Module`)
4  else console.log(`File ${path} is a Script`)

Test

1npm test

test/index.js ..................................... 213/213
total ............................................. 213/213

  213 passing (927.584ms)

  ok
----------|----------|----------|----------|----------|-------------------|
File      |  % Stmts | % Branch |  % Funcs |  % Lines | Uncovered Line #s |
----------|----------|----------|----------|----------|-------------------|
All files |      100 |      100 |      100 |      100 |                   |
 index.js |      100 |      100 |      100 |      100 |                   |
----------|----------|----------|----------|----------|-------------------|

License

MIT