#48427: docs: recommend calling renderer process modules from preload script
Merged
Description of Change
Refs #45666
As discussed here. CC @MarshallOfSound.
We've had many confused users in the bug tracker who had context isolation enabled and struggled to call webUtils.getPathForFile. This makes it clear that when context isolation is enabled, renderer process modules need to be called from the preload script.
Checklist
- PR description included and stakeholders cc'd
-
npm testpasses - relevant API documentation, tutorials, and examples are updated and follow the documentation style guide
- PR release notes describe the change in a way relevant to app developers, and are capitalized, punctuated, and past tense.
Release Notes
Notes: none
Backports
38-x-y
MergedPR Number
#48462Merged At
Oct 4, 2025, 5:23:42 PM
Released In
v38.2.2Release Date
Oct 7, 2025, 11:03:07 AM
39-x-y
MergedPR Number
#48461Merged At
Oct 4, 2025, 5:23:34 PM
Released In
v39.0.0-alpha.9Release Date
Oct 6, 2025, 8:32:10 AM
Semver Impact
Major
Breaking changes
Minor
New features
Patch
Bug fixes
None
Docs, tests, etc.
Semantic Versioning helps users understand the impact of updates:
- Major (X.y.z): Breaking changes that may require code modifications
- Minor (x.Y.z): New features that maintain backward compatibility
- Patch (x.y.Z): Bug fixes that don't change the API
- None: Changes that don't affect using facing parts of Electron