Service Workers API
The setHeaderValue() method of the NavigationPreloadManager interface sets the value of the Service-Worker-Navigation-Preload header that will be sent with requests resulting from a Window/fetch operation made during service worker navigation preloading.
It returns an empty Promise that resolves with undefined.
The presence of the Service-Worker-Navigation-Preload header in preloading requests allows servers to configure the returned resource differently for preloading fetch requests than from normal fetch requests.
The default directive is set to true: this method allows the possibility of configuring multiple different responses to preload requests.
[!NOTE] If a different response may result from setting this header, the server must set
Vary: Service-Worker-Navigation-Preloadto ensure that the different responses are cached.
Syntax
setHeaderValue(value)
Parameters
value- : An arbitrary string value, which the target server uses to determine what should be returned for the requested resource.
Return value
A Promise that resolves with undefined.
Exceptions
InvalidStateErrorDOMException- : There is no active worker associated with the registration to which this NavigationPreloadManager belongs.
Examples
The code below demonstrates how the value might be set.
navigator.serviceWorker.ready
.then((registration) =>
registration.navigationPreload.setHeaderValue(newValue),
)
.then(() => console.log("Done!"))
.catch((e) =>
console.error(`NavigationPreloadManager not supported: ${e.message}`),
);
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
