This directory contains a framework to test features with permissions policy.
When adding a new feature to permissions policy, the following cases should be tested:
Use test_feature_availability()
defined in /permissions-policy/resources/permissions-policy.js
. Please refer to the comments in /permissions-policy/resources/permissions-policy.js
for how this function works.
HTTP tests are used to test features with header policy.
Define the header policy in <feature-name>-<enabled | disabled | enabled-on-self-origin>-by-permissions-policy.https.sub.html.headers
. Example:
Permissions-Policy: feature-name=*
In <feature-name>-<enabled | disabled | enabled-on-self-origin>-by-permissions-policy.https.sub.html
:
test if feature is enabled / disabled in the main frame;
test if feature is enabled / disabled in a same-origin iframe;
test if feature is enabled / disabled in a cross-origin iframe.
Examples: /permissions-policy/payment-disabled-by-permissions-policy.https.sub.html
/permissions-policy/payment-disabled-by-permissions-policy.https.sub.html.headers
Simply use test_feature_availability()
with the optional argument feature_name
specified to test if:
Example: /permissions-policy/payment-allowed-by-permissions-policy-attribute.https.sub.html
Similar to the section above, append /permissions-policy/resources/redirect-on-load.html#
to the argument src
passed to test_feature_availability()
.
Example: /permissions-policy/payment-allowed-by-permissions-policy-attribute-redirect-on-load.https.sub.html