TrustedTypePolicyFactory: метод createPolicy()

Метод createPolicy() интерфейса TrustedTypePolicyFactory создаёт объект TrustedTypePolicy, который реализует правила, переданные в виде policyOptions.

В Chrome политика с именем "default" создаёт специальную политику, которая будет использоваться, если в токен ввода передаётся строка (а не объект Trusted Type). Это может быть использовано в переходный период при переходе от приложения, которое вставляло строки в токены ввода.

policyName

Строка с именем политики.

policyOptions Необязательно

Пользовательские функции для преобразования строк в надёжные значения.

createHTML(input[,args])

Функция обратного вызова в виде строки, содержащей код, который нужно выполнить при создании объекта TrustedHTML.

createScript(input[,args])

Функция обратного вызова в виде строки, содержащей код, который нужно выполнить при создании объекта TrustedScript.

createScriptURL(input[,args])

Функция обратного вызова в виде строки, содержащей код, который нужно выполнить при создании объекта TrustedScriptURL.

Объект TrustedTypePolicy.

TypeError

Выбрасывается, если имена политик ограничены директивой Content Security Policy trusted-types и это имя не находится в списке разрешённых.

TypeError

Выбрасывается, если имя является дубликатом, и директива Content Security Policy trusted-types не использует allow-duplicates.

В приведенном ниже коде создаётся политика с именем "myEscapePolicy" с определённой функцией для createHTML(), которая очищает HTML.

const escapeHTMLPolicy = trustedTypes.createPolicy("myEscapePolicy", {
  createHTML: (string) => string.replace(/</g, "&lt;"),
});

На сайте, где Trusted Types применяются через Content Security Policy с директивой require-trusted-types-for, установленной в script, любой скрипт вставки, принимающий скрипт, ожидает объект Trusted Type. В случае, если вместо этого вставляется строка, будет использоваться следующая политика по умолчанию.

Политика регистрирует сообщение в консоли, чтобы напомнить разработчику о необходимости переписать эту часть приложения для использования объекта Trusted Type. Она также добавляет сведения об использовании политики по умолчанию, типе и токенах ввода в возвращаемое значение.

trustedTypes.createPolicy("default", {
  createScriptURL: (s, type, sink) => {
    console.log("Please refactor.");
    return `${s}?default-policy-used&type=${encodeURIComponent(
      type,
    )}&sink=${encodeURIComponent(sink)}`;
  },
});