diff --git a/doc/api/permissions.md b/doc/api/permissions.md index 0b46f42d982..3f88b772473 100644 --- a/doc/api/permissions.md +++ b/doc/api/permissions.md @@ -28,6 +28,15 @@ If you find a potential security vulnerability, please refer to our ### Permission Model + +When the Permission Model is enabled in the parent process, creating a +`worker_threads.Worker` with an explicit `execArgv` option (including an empty +array) no longer allows the worker to obtain a wider permission-related grant +set than the parent. Permission-related grants on the worker are limited to a +subset of the parent's grants. Non-permission `execArgv` flags are unaffected. +This is a breaking change relative to earlier releases where `execArgv: []` +could drop the parent's Permission Model grants. + +**Permission Model (breaking):** If the parent process runs with the +Permission Model enabled, an explicit `execArgv` (including `[]`) does not +disable or exceed the parent's permission-related grants. See the Permission +Model documentation. +