Permissions-Policy: web-share directive

{{SeeCompatTable}} 

The HTTP {{HTTPHeader('Permissions-Policy')}}  header web-share directive controls whether the current document is allowed to use the {{domxref("Navigator.share","Navigator.share()")}}  method of the Web Share API to share text, links, images, and other content to arbitrary destinations of the user’s choice.

Specifically, where a defined policy blocks usage of this feature, {{domxref("Navigator.share()")}}  calls will return a {{jsxref("Promise")}}  that rejects with a {{domxref("DOMException")}}  of type NotAllowedError.

Syntax

Permissions-Policy: web-share=<allowlist>;

• <allowlist>
  • : A list of origins for which permission is granted to use the feature. See Permissions-Policy > Syntax for more details.

Default policy

The default allowlist for web-share is self.

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• {{HTTPHeader('Permissions-Policy')}}  header
• Permissions Policy