Overview

The $templateRequest service runs security checks then downloads the provided template using $http and, upon success, stores the contents inside of $templateCache. If the HTTP request fails or the response data of the HTTP request is empty, a $compile error will be thrown (the exception can be thwarted by setting the 2nd parameter of the function to true). Note that the contents of $templateCache are trusted, so the call to $sce.getTrustedUrl(tpl) is omitted when tpl is of type string and $templateCache has the matching entry.

If you want to pass custom options to the $http service, such as setting the Accept header you can configure this via $templateRequestProvider.

$templateRequest is used internally by $compile, $route, and directives such as ngInclude to download and cache templates.

3rd party modules should use $templateRequest if their services or directives are loading templates.

Usage

$templateRequest(tpl, [ignoreRequestError]);

Arguments

Param

Type

Details

tpl

stringTrustedResourceUrl

The HTTP request template URL

ignoreRequestError

(optional)

boolean

Whether or not to ignore the exception when the request fails or the template is empty