#50563: docs: recommend subdirectory for userData to avoid Chromium conflicts
Merged
Created: Mar 28, 2026, 8:39:00 PM
Merged: Apr 1, 2026, 9:54:08 AM
3 comments
Target: main
Description of Change
- add a recommendation in the
app.getPath('userData')documentation to store app-specific files within a subdirectory ofuserDatarather than directly in its root - this avoids naming conflicts with Chromium's own subdirectories (
Cache,GPUCache,Local Storage, etc.) that can cause unexpected behavior
Fixes #45414
Checklist
- PR description included
- 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: no-notes
Backports
42-x-y
MergedPR Number
#50625Merged At
Apr 1, 2026, 8:16:14 PM
Released In
v42.0.0-beta.1Release Date
Apr 6, 2026, 7:51:17 PM
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