Skip to content

module: custom --conditions flag option #34637

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
guybedford wants to merge 10 commits into from
Closed

module: custom --conditions flag option #34637

Changes from 1 commit
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
11928c7
module: custom --conditions flag option
guybedford Aug 5, 2020
5dc585d
fixup resolution bugs
guybedford Aug 5, 2020
936a213
remove condition alias for now
guybedford Aug 5, 2020
e1a91c8
todo is done
guybedford Aug 5, 2020
ed69235
-m alias, docs
guybedford Aug 5, 2020
0180f86
doc reorder
guybedford Aug 5, 2020
dba70c1
rename heading
guybedford Aug 5, 2020
52f216c
use -u short flag
guybedford Aug 5, 2020
acbe3ee
Apply suggestions from code review
guybedford Aug 5, 2020
1ed44a4
use multiple flags over comma separated
guybedford Aug 5, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
doc reorder
  • Loading branch information
@guybedford
guybedford committed Aug 5, 2020
commit 0180f8648527f64a4a00f4bc1daffeb1660ba52d
24 changes: 13 additions & 11 deletions doc/api/esm.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -475,17 +475,6 @@ order to support packages with conditional exports. For this reason, using
`"node"` and `"default"` condition branches is usually preferable to using
`"node"` and `"browser"` condition branches.

When running Node.js, custom comma-separated conditions can be set with the
`--conditions` or `-m` flag:

```bash
node --conditions=development main.js
```

which would then resolve the `"development"` condition in exports, along with
the existing `"node"`, `"default"`, `"import"` and `"require"` conditions as
appropriate.

#### Nested conditions

In addition to direct mappings, Node.js also supports nested condition objects.
Expand All @@ -512,6 +501,19 @@ a nested conditional does not have any mapping it will continue checking
the remaining conditions of the parent condition. In this way nested
conditions behave analogously to nested JavaScript `if` statements.

#### Executing custom conditions

When running Node.js, custom comma-separated conditions can be set with the
Comment thread
guybedford marked this conversation as resolved.
Outdated
`--conditions` or `-m` flag:
Comment thread
guybedford marked this conversation as resolved.
Outdated

```bash
node --conditions=development main.js
```

which would then resolve the `"development"` condition in exports, along with
the existing `"node"`, `"default"`, `"import"` and `"require"` conditions as
Comment thread
guybedford marked this conversation as resolved.
Outdated
appropriate.

#### Self-referencing a package using its name

Within a package, the values defined in the package’s
Expand Down