Улучшить документацию Просмотреть исходный код $sceDelegate

$sceDelegateProvider
сервис в модуле ng

$sceDelegate — это сервис, используемый сервисом $sce, чтобы предоставлять AngularJS сервисы строгого контекстного экранирования (SCE).

Обычно для настройки или переопределения работы строгого контекстного экранирования в AngularJS вы настраиваете или переопределяете $sceDelegate, а не сервис $sce. Это потому, что, хотя $sce предоставляет множество сокращенных методов и т. д., вам действительно нужно переопределить только 3 основных функции (trustAs, getTrusted и valueOf). Это необходимо, поскольку $sce делегирует эти операции $sceDelegate.

Для настройки этого сервиса см. $sceDelegateProvider.

Стандартная реализация $sceDelegate должна работать без проблем. Хотя вы можете полностью переопределить её, чтобы изменить поведение $sce, чаще всего приходится настраивать $sceDelegateProvider, задавая собственные белые и черные списки доверенных URL-адресов, используемых для загрузки ресурсов AngularJS, таких как шаблоны. См. $sceDelegateProvider.resourceUrlWhitelist и $sceDelegateProvider.resourceUrlBlacklist.

Использование

$sceDelegate();

Методы

trustAs(type, value);

Возвращает объект, которому Angular доверяет для использования в указанных контекстах строгого контекстного экранирования (например, ng-bind-html, ng-include, интерполяции любого атрибута src, интерполяции любого атрибута привязки событий DOM, такого как onclick и т. д.). См. $sce для включения строгого контекстного экранирования.

Параметры

Параметр	Тип	Подробности
type	`string`	Тип контекста, в котором это значение безопасно для использования. Например, url, resourceUrl, html, js и css.
value	`*`	Значение, которое должно считаться доверенным/безопасным.

Возвращаемое значение

`*`	Значение, которое можно использовать для обозначения предоставленного `value` в местах, где Angular ожидает возвращаемого значения $sce.trustAs().

valueOf(value);

Если переданный параметр был возвращён предыдущим вызовом $sceDelegate.trustAs, возвращает значение, которое было передано в $sceDelegate.trustAs.

Если переданный параметр не является значением, возвращённым $sceDelegate.trustAs, возвращает его как есть.

Параметры

Параметр	Тип	Подробности
value	`*`	Результат предыдущего вызова `$sceDelegate.trustAs` или что-то другое.

Возвращаемое значение

`*`	Исходное значение, переданное в `$sceDelegate.trustAs`, если `value` является результатом такого вызова. В противном случае возвращает `value` без изменений.

getTrusted(type, maybeTrusted);

Принимает результат вызова $sceDelegate.trustAs и возвращает исходное значение, если тип запрошенного контекста является супертипом созданного типа. Если это условие не выполняется, выбрасывается исключение.

Параметры

Параметр	Тип	Подробности
type	`string`	Тип контекста, в котором это значение должно быть использовано.
maybeTrusted	`*`	Результат предыдущего вызова `$sceDelegate.trustAs`.

Возвращаемое значение

`*`	Значение, первоначально предоставленное `$sceDelegate.trustAs`, если оно допустимо в этом контексте. В противном случае выбрасывается исключение.

© 2010–2017 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://code.angularjs.org/1.4.14/docs/api/ng/service/$sceDelegate