Improve this Doc View Source $templateRequest

  1. $templateRequestProvider
  2. 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 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

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