Skip to content

doc: reflect vfs improvements in sea page #67096

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

Open
GauBen wants to merge 1 commit into
base: main
Choose a base branch
from
Open

doc: reflect vfs improvements in sea page #67096

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
14 changes: 8 additions & 6 deletions doc/api/single-executable-applications.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -325,12 +325,14 @@ implementation, not a technical impossibility. Consider bundling the
application if startup performance matters and do not rely on module loading
from the VFS in that case.

#### Native addon limitations

Native addons (`.node` files) cannot be loaded directly from the VFS because
`process.dlopen()` requires files on the real file system. To use native
addons in a SEA with VFS, write the asset to a temporary file first. See
[Using native addons in the injected main script][] for an example.
#### Native addons

Native addons (`.node` files) bundled as assets can be loaded from the VFS
with `require()` or `process.dlopen()`. The operating system's dynamic loader
cannot open a virtual path, so the addon is loaded from a private,
self-cleaning temporary image instead. See [module loader integration][] for
details. Without `useVfs`, see
[Using native addons in the injected main script][].

### Startup snapshot support

Expand Down