diff --git a/files/en-us/web/http/reference/headers/permissions-policy/bluetooth/index.md b/files/en-us/web/http/reference/headers/permissions-policy/bluetooth/index.md index 487ef2455fa37b2..03ec559ab74a330 100644 --- a/files/en-us/web/http/reference/headers/permissions-policy/bluetooth/index.md +++ b/files/en-us/web/http/reference/headers/permissions-policy/bluetooth/index.md @@ -30,36 +30,37 @@ Permissions-Policy: bluetooth=; ## Default policy -The default allowlist for `bluetooth` is `self`. +The default allowlist for `bluetooth` is `self`. The top-level browsing context and same-origin iframes are allowed access to the `bluetooth` feature by default. ## Examples -### General example +### Basic usage -SecureCorp Inc. wants to disable the Web Bluetooth API within all browsing contexts except for its own origin and those whose origin is `https://example.com`. -It can do so by delivering the following HTTP response header to define a Permissions Policy: +SecureCorp Inc. wants to disallow `bluetooth` within all cross-origin iframes except those whose origin is `https://example.com`. It can do so by delivering the following HTTP response header to define a Permissions Policy: ```http Permissions-Policy: bluetooth=(self "https://example.com") ``` -### With an \ ``` -Then include an {{HTMLElement('iframe','allow','#Attributes')}} attribute on the ` ``` -` ``` -Then include an {{HTMLElement('iframe','allow','#Attributes')}} attribute on the ` ``` -iframe attributes can selectively enable features in certain frames, and not in others, even if those frames contain documents from the same origin. - ## Specifications {{Specifications}} diff --git a/files/en-us/web/http/reference/headers/permissions-policy/geolocation/index.md b/files/en-us/web/http/reference/headers/permissions-policy/geolocation/index.md index da49e81ed03d96b..6f21ec0b96111b8 100644 --- a/files/en-us/web/http/reference/headers/permissions-policy/geolocation/index.md +++ b/files/en-us/web/http/reference/headers/permissions-policy/geolocation/index.md @@ -21,10 +21,6 @@ Specifically, where a defined policy blocks use of this feature, calls to callbacks to be invoked with a {{domxref('GeolocationPositionError')}} code of `PERMISSION_DENIED`. -By default, the Geolocation API can be used within top-level documents and their -same-origin child frames. This directive allows or prevents cross-origin frames from -accessing geolocation. This includes same-origin frames. - ## Syntax ```http @@ -36,40 +32,37 @@ Permissions-Policy: geolocation=; ## Default policy -The default allowlist for `geolocation` is `self`. +The default allowlist for `geolocation` is `self`. The top-level browsing context and same-origin iframes are allowed access to the `geolocation` feature by default. ## Examples -### General example +### Basic usage -SecureCorp Inc. wants to disable the Geolocation API within all browsing contexts -except for its own origin and those whose origin is `https://example.com`. It -can do so by delivering the following HTTP response header to define a Permissions Policy: +SecureCorp Inc. wants to disallow `geolocation` within all cross-origin iframes except those whose origin is `https://example.com`. It can do so by delivering the following HTTP response header to define a Permissions Policy: ```http Permissions-Policy: geolocation=(self "https://example.com") ``` -### With an \ ``` -Then include an {{HTMLElement('iframe','allow','#Attributes')}} attribute on the -` + ``` -Interestingly, `allow` attributes can selectively enable features in certain frames, and not in others, -even if those frames contain documents from the same origin. - ## Specifications {{Specifications}}