Improve this Doc View Source $templateRequest
Improve this Doc View Source $templateRequest
- $templateRequestProvider
- service in module ng
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 | string TrustedResourceUrl
|
The HTTP request template URL |
ignoreRequestError (optional) |
boolean
|
Whether or not to ignore the exception when the request fails or the template is empty |
Returns
Promise
|
a promise for the HTTP response data of the given URL. |
Properties
- === totalPendingRequests ===
number
total amount of pending template requests being downloaded.
© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
https://code.angularjs.org/1.8.2/docs/api/ng/service/$templateRequest