Skip to content

Commit

Permalink
fixup! doc: add warning for esm specifier resolution
Browse files Browse the repository at this point in the history
  • Loading branch information
GeoffreyBooth committed Mar 9, 2022
1 parent 440672b commit 43b7067
Showing 1 changed file with 9 additions and 9 deletions.
18 changes: 9 additions & 9 deletions doc/api/esm.md
Original file line number Diff line number Diff line change
Expand Up @@ -677,7 +677,7 @@ of Node.js applications.
> Stability: 1 - Experimental
**Note: This API is currently being redesigned and will still change.**
> This API is currently being redesigned and will still change.
<!-- type=misc -->
Expand All @@ -700,7 +700,7 @@ changes:
description: Add support for import assertions.
-->
> Note: The loaders API is being redesigned. This hook may disappear or its
> The loaders API is being redesigned. This hook may disappear or its
> signature may change. Do not rely on the API described below.
* `specifier` {string}
Expand Down Expand Up @@ -773,10 +773,10 @@ export async function resolve(specifier, context, defaultResolve) {

#### `load(url, context, defaultLoad)`

> Note: The loaders API is being redesigned. This hook may disappear or its
> The loaders API is being redesigned. This hook may disappear or its
> signature may change. Do not rely on the API described below.

> Note: In a previous version of this API, this was split across 3 separate, now
> In a previous version of this API, this was split across 3 separate, now
> deprecated, hooks (`getFormat`, `getSource`, and `transformSource`).

* `url` {string}
Expand Down Expand Up @@ -814,7 +814,7 @@ overcome in the future.
> are incompatible. Attempting to use them together will result in an empty
> object from the import. This may be addressed in the future.

> Note: These types all correspond to classes defined in ECMAScript.
> These types all correspond to classes defined in ECMAScript.

* The specific [`ArrayBuffer`][] object is a [`SharedArrayBuffer`][].
* The specific [`TypedArray`][] object is a [`Uint8Array`][].
Expand Down Expand Up @@ -864,10 +864,10 @@ source to a supported one (see [Examples](#examples) below).

#### `globalPreload()`

> Note: The loaders API is being redesigned. This hook may disappear or its
> The loaders API is being redesigned. This hook may disappear or its
> signature may change. Do not rely on the API described below.

> Note: In a previous version of this API, this hook was named
> In a previous version of this API, this hook was named
> `getGlobalPreloadCode`.

* Returns: {string}
Expand Down Expand Up @@ -1456,9 +1456,9 @@ _internal_, _conditions_)

> Stability: 1 - Experimental

> **Note: Do not rely on this flag. We plan to remove it once the
> Do not rely on this flag. We plan to remove it once the
> [Loaders API][] has advanced to the point that equivalent functionality can
> be achieved via custom loaders.**
> be achieved via custom loaders.

The current specifier resolution does not support all default behavior of
the CommonJS loader. One of the behavior differences is automatic resolution
Expand Down

0 comments on commit 43b7067

Please sign in to comment.