third_party/blink/renderer/core/permissions_policy/document_policy_features.json5

{
  // All document policy (https://w3c.github.io/webappsec-permissions-policy/document-policy.html)
  // features are defined here.
  // All Features have to be defined in DocumentPolicyFeature enum as well
  // (defined in third_party/blink/public/mojom/permissions_policy/document_policy_feature.mojom).
  // The enum value has to have the same name as the feature name here.

  parameters: {
    // document_policy_name: "FEATURE_NAME" is used to specify the policy name
    // which gets parsed from the header or the policy attribute.
    document_policy_name: {},
    // value type allowed in mojom::PolicyValueType which is defined in
    // third_party/blink/public/mojom/permissions_policy/policy_value.mojom.
    value_type: {},
    // valid c++ expression strings, e.g. true/false, 1.0, -1.
    // or use reserved keyword 'min'/'max'.
    // For Enum features, use the underlying integer value (not a named constant).
    default_value: {},
    // "depends_on" specifies relationship to runtime features defined
    // in "runtime_enabled_features.json5":
    // depends_on: ["feature1", "feature2", ...]
    // * If the depends_on features are *only* runtime features, the feature is
    //   available if any of the runtime features are enabled.
    // * If the depends_on list includes origin trial features, the feature is
    //   available if any of the origin trial features are enabled.
    depends_on: {
      default: [],
      valid_type: "list",
    },
    // "default_value_behind_flag" specifies default_value override values
    // based on different runtime flags set.
    //
    // When multiple flags are set, default_value correspond to the first
    // flag in the list will be used, e.g.
    //   default_value_behind_flag: [
    //    ["A", 1.0],
    //    ["B", 2.0],
    //   ]
    // 1.0 will be used as default value when both flag A and B are set.
    //
    // Note: the runtime flags here refer to features defined in
    // "third_party/blink/public/common/features.h", instead of those defined in
    // "runtime_enabled_features.json5" because the latter is only available
    // on renderer side, while default_value is needed from browser side as
    // well.
    default_value_behind_flag: {
      default: [],
      valid_type: "list",
    }
  },

  data: [
    {
      name: "Default",
      document_policy_name: "*",
      value_type: "Bool",
      default_value: "true",
      depends_on: []
    },
    {
      // The ForceLoadAtTop policy lets pages opt-out of scrolling that
      // automatically happens on page load. This includes fragment scrolls,
      // text fragment scrolls (i.e. this provides an opt-out for the Scroll To
      // Text feature), and scroll restoration.
      name: "ForceLoadAtTop",
      document_policy_name: "force-load-at-top",
      value_type: "Bool",
      default_value: "false",
    },
    {
      name: "JSProfiling",
      document_policy_name: "js-profiling",
      value_type: "Bool",
      default_value: "false",
    },
    {
      name: "SyncXHR",
      document_policy_name: "sync-xhr",
      value_type: "Bool",
      default_value: "true",
      depends_on: ["DocumentPolicySyncXHR"],
    },
    {
      name: "IncludeJSCallStacksInCrashReports",
      document_policy_name: "include-js-call-stacks-in-crash-reports",
      value_type: "Bool",
      default_value: "false",
    },
    {
      name: "ExpectNoLinkedResources",
      document_policy_name: "expect-no-linked-resources",
      value_type: "Bool",
      default_value: "false",
      depends_on: ["DocumentPolicyExpectNoLinkedResources"]
    },
    {
      name: "NetworkEfficiencyGuardrails",
      document_policy_name: "network-efficiency-guardrails",
      // TODO(crbug.com/1456695): consider turning into enum for versioning
      // support
      value_type: "Bool",
      default_value: "false",
      depends_on: ["DocumentPolicyNetworkEfficiencyGuardrails"]
    },
    {
      name: "JSProfilingMode",
      document_policy_name: "js-profiling-mode",
      value_type: "Enum",
      // 0 is the default "not set" representation. The only valid header tokens
      // are "eager" (1) and "lazy" (2); there is no "none" token. So value 0
      // can only come from the default — GetProfilingMode treats it as "not
      // explicitly set" and falls through to the legacy kJSProfiling policy.
      default_value: "0",
      depends_on: ["DocumentPolicyJSProfilingMode"]
    }
  ],
}