bare-module

Parameter	Type	Default	Description
`specifier`	`string`	—	The asset specifier to resolve.
`parentURL`	`URL`	—	The WHATWG `URL` to resolve `specifier` relative to.
`opts?`	`Options`	—	Resolution options.

Returns URL — The WHATWG URL of the resolved asset.

Throws

ASSET_NOT_FOUND — no asset matching specifier could be found relative to parentURL.
TypeError — specifier is not a string.

`Module.builtinModules: Module[]`

_Source

Always an empty array; provided for Node.js compatibility.

`Module.cache: Cache`

_Source

`Module.constants`

Module.constants: {
  states: {
    EVALUATED: number
    SYNTHESIZED: number
    RUN: number
  }
  types: {
    SCRIPT: number
    MODULE: number
    JSON: number
    BUNDLE: number
    ADDON: number
    BINARY: number
    TEXT: number
    ASSET: number
  }
}

_Source

Constants describing module states (EVALUATED, SYNTHESIZED, RUN) and module types (SCRIPT, MODULE, JSON, BUNDLE, ADDON, BINARY, TEXT, ASSET).

`Module.createRequire(parentURL: string | URL, opts?: CreateRequireOptions): Require`

_Source

Create a preconfigured require() bound to parentURL, so specifiers resolve and load relative to it.

Parameters

Parameter	Type	Default	Description
`parentURL`	`string` \| `URL`	—	The parent URL that the returned `require()` resolves and loads specifiers relative to.
`opts?`	`CreateRequireOptions`	—	Options for the created `require()`, such as its `protocol` and `cache`.

Returns Require — A require() bound to parentURL, with main, cache, resolve, addon, and asset attached.

`Module.isBuiltin(): boolean`

_Source

Always returns false; provided for Node.js compatibility.

`Module.load(url: URL, opts: LoadOptions): Module`

_Source

Load a module with the provided url. url is a WHATWG URL. If provided, the source will be passed to the matching extension for the url.

Overloads:

Module.load(url: URL, opts: LoadOptions): Module
Module.load(url: URL, source?: Buffer | string | Bundle | null, opts?: LoadOptions): Module

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The WHATWG `URL` of the module to load.
`opts`	`LoadOptions`	—	Load options; may carry a `source` to load directly instead of reading it through the protocol.

Returns Module — The loaded Module, reusing the cached instance if url was already loaded.

Throws

TYPE_INCOMPATIBLE — a module is already cached for url with a type incompatible with the requested type.

`Module.protocol: Protocol`

_Source

The ModuleProtocol class for resolving, reading and loading modules. See Protocols for usage.

`Module.resolve(specifier: string, parentURL: URL, opts?: ResolveOptions): URL`

_Source

Resolve the module specifier relative to the parentURL. specifier is a string and parentURL is a WHATWG URL.

Parameters

Parameter	Type	Default	Description
`specifier`	`string`	—	The module specifier to resolve.
`parentURL`	`URL`	—	The WHATWG `URL` to resolve `specifier` relative to.
`opts?`	`ResolveOptions`	—	Resolution options.

Returns URL — The WHATWG URL that specifier resolves to.

Throws

MODULE_NOT_FOUND — no module matching specifier could be found relative to parentURL.
TypeError — specifier is not a string.

`path: string`

_Source

`protocol: Protocol`

_Source

The ModuleProtocol class for resolving, reading and loading modules. See Protocols for usage.

`resolutions: ResolutionsMap`

_Source

A map of preresolved imports with keys being serialized parent URLs and values being "imports" maps.

`type: number`

_Source

The type of the module. See Module.constants.types for possible values.

`url: URL`

_Source

The WHATWG URL identifier of the module.

ModuleProtocol

`new ModuleProtocol(methods?: Partial<ModuleProtocol>, context?: ModuleProtocol)`

_Source

Defines how modules are resolved, read and loaded; custom protocols can serve modules from outside the file system, such as a Hyperdrive or a bare-bundle.

Parameters

Parameter	Type	Default	Description
`methods?`	`Partial<ModuleProtocol>`	—	Protocol method overrides; any of `preresolve`, `postresolve`, `resolve`, `exists`, `read`, `addon`, or `asset`.
`context?`	`ModuleProtocol`	—	An existing protocol to fall back to for any method not provided in `methods`.

`addon(url: URL): URL`

_Source

Post-process URLs for addons before postresolve().

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The resolved addon `URL` to post-process.

`asset(url: URL): URL`

_Source

Post-process URLs for assets before postresolve().

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The resolved asset `URL` to post-process.

`exists(url: URL, type: number): boolean`

_Source

Return whether the URL exists.

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The `URL` to check for existence.
`type`	`number`	—	The module type being probed (see `Module.constants.types`).

`extend(methods: Partial<ModuleProtocol>): ModuleProtocol`

_Source

Create a new protocol that uses this protocol as its context, overriding the given methods.

Parameters

Parameter	Type	Default	Description
`methods`	`Partial<ModuleProtocol>`	—	Protocol method overrides for the new protocol.

Returns ModuleProtocol — A new ModuleProtocol that uses this protocol as its context, with methods overriding.

`postresolve(url: URL): URL`

_Source

Process the resolved URL; can be used to convert file paths, etc.

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The resolved `URL` to post-process.

Returns URL — The (possibly transformed) resolved URL.

`preresolve(specifier: string, parentURL: URL): string`

_Source

Preprocess the specifier and parentURL before the resolve algorithm is called.

Parameters

Parameter	Type	Default	Description
`specifier`	`string`	—	The module specifier being resolved.
`parentURL`	`URL`	—	The `URL` the specifier is resolved relative to.

Returns string — The (possibly rewritten) specifier to pass into the resolve algorithm.

`read(url: URL): Buffer | string | null`

_Source

Return the source code of a URL, represented as a string or buffer.

Parameters

Parameter	Type	Default	Description
`url`	`URL`	—	The `URL` to read.

Returns Buffer | string | null — The source of url as a Buffer or string, or null if it does not exist.

`resolve(specifier: string, parentURL: URL, imports: ImportsMap): URL`

_Source

Resolve the specifier to a URL.

Parameters

Parameter	Type	Default	Description
`specifier`	`string`	—	The module specifier to resolve.
`parentURL`	`URL`	—	The `URL` to resolve `specifier` relative to.
`imports`	`ImportsMap`	—	The `"imports"` map to apply during resolution.

Types

`Attributes`

interface Attributes {
  type: Lowercase<keyof typeof constants.types>
}

_Source

Import attributes instructing how a module should be loaded.

`Cache`

interface Cache {
  [href: string]: Module
}

_Source

A map of module URL hrefs to loaded modules.

`Options`

interface Options {
  attributes?: Attributes
  builtins?: Builtins
  cache?: Cache
  conditions?: Conditions
  defaultType?: number
  imports?: ImportsMap
  main?: Module
  protocol?: Protocol
  referrer?: Module
  resolutions?: ResolutionsMap
  type?: number
}

_Source

`LoadOptions`

interface LoadOptions extends Options {
  isDynamicImport?: boolean
  isImport?: boolean
}

_Source

`ResolveOptions`

interface ResolveOptions extends Options {
  isImport?: boolean
}

_Source

`CreateRequireOptions`

interface CreateRequireOptions extends Options {
    module?: Module
  }

_Source

`RequireOptions`

interface RequireOptions {
    with?: Attributes
  }

_Source

Options for require(); with holds the import attributes.

`RequireAddon`

interface RequireAddon {
    (specifier?: string, parentURL?: URL): string
    host: string
    resolve: (specifier: string, parentURL?: URL) => unknown
  }

_Source

The require.addon function: imports addon modules, with host and resolve attached.

`Require`

interface Require {
    (parentURL: string | URL, opts?: RequireOptions): unknown
    main: Module
    cache: Cache
    resolve: (specifier: string, parentURL?: URL) => string
    addon: RequireAddon
    asset: (specifier: string, parentURL?: URL) => string
  }

_Source

The function returned by Module.createRequire(): resolves and loads modules relative to its parent URL, with main, cache, resolve, addon, and asset attached.

bare-module

On this page