@types/serviceworker

@types/serviceworker - Types for the global scope of Service Workers

Service workers essentially act as proxy servers that sit between web applications, the browser, and the network (when available). They are intended, among other things, to enable the creation of effective offline experiences, intercept network requests and take appropriate action based on whether the network is available, and update assets residing on the server. They will also allow access to push notifications and background sync APIs.

From MDN Web Docs: Service Worker API

This package contains type definitions which will set up the global environment for your TypeScript project to match the runtime environment of a Service Worker. The APIs inside @types/serviceworker are generated from the specifications for JavaScript. Given the size and state of constant change in web browsers, @types/serviceworker only has APIs which have passed a certain level of standardization and are available in at least two of the most popular browser engines.

Installation

To use @types/serviceworker you need to do two things:

1. Install the dependency: npm install @types/serviceworker --save-dev, yarn add @types/serviceworker --dev or pnpm add @types/serviceworker --dev.

2. Update your tsconfig.json to avoid clashing with the DOM APIs. There are two cases to consider depending on if you have lib defined in your tsconfig.json or not.

   1. Without "lib" - You will need to add "lib": []. The value you want to add inside your lib should correlate to your "target". For example if you had "target": "es2017", then you would add "lib": ["es2017"]
   2. With "lib" - You should remove "dom".

That's all.

If you'd like to ensure that the DOM types are never accidentally included, you can use @orta/types-noop in TypeScript 4.5+.

SemVer

This project does not respect semantic versioning as almost every change could potentially break a project, though we try to minimize removing types.

@types/serviceworker follow the specifications, so when they mark a function/object/API/type as deprecated or removed - that is respected.

Deploy Metadata

You can read what changed in version 0.0.100 at https://github.com/microsoft/TypeScript-DOM-lib-generator/releases/tag/%40types%2Fserviceworker%400.0.100.