doc: caveat unavailability of import.meta.resolve in custom loaders

PR-URL: #49242 Backport-PR-URL: #50669 Reviewed-By: Antoine du Hamel <[email protected]> Reviewed-By: Geoffrey Booth <[email protected]>
nodejs · Nov 23, 2023 · 58eaf3f · 58eaf3f
1 parent e8d475f
commit 58eaf3f
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/doc/api/esm.md b/doc/api/esm.md
@@ -375,6 +375,9 @@ behind the `--experimental-import-meta-resolve` flag:
 
 * `parent` {string|URL} An optional absolute parent module URL to resolve from.
 
+> **Caveat** This feature is not available within custom loaders (it would
+> create a deadlock).
+
 ## Interoperability with CommonJS
 
 ### `import` statements