# ServiceWorkerControllerCompat

Artifact: [androidx.webkit:webkit](https://developer.android.com/jetpack/androidx/releases/webkit) [View Source](https://cs.android.com/search?q=file:androidx/webkit/ServiceWorkerControllerCompat.java+class:androidx.webkit.ServiceWorkerControllerCompat) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/webkit#1.1.0)

*** ** * ** ***


```
@AnyThread
abstract class ServiceWorkerControllerCompat
```

<br />

*** ** * ** ***

Manages Service Workers used by WebView.

Example usage:

```kotlin
ServiceWorkerControllerCompat swController = ServiceWorkerControllerCompat.getInstance();
swController.setServiceWorkerClient(new ServiceWorkerClientCompat() {
  @Override
  public WebResourceResponse shouldInterceptRequest(WebResourceRequest request) {
    // Capture request here and generate response or allow pass-through
    // by returning null.
    return null;
  }
});
```

## Summary

| ### Public functions |
|---|---|
| `java-static https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerControllerCompat` | `@https://developer.android.com/reference/kotlin/androidx/annotation/RequiresFeature(name = https://developer.android.com/reference/kotlin/androidx/webkit/WebViewFeature.SERVICE_WORKER_BASIC_USAGE, enforcement = "androidx.webkit.WebViewFeature#isFeatureSupported") https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerControllerCompat#getInstance()()` Returns the default ServiceWorkerController instance. |
| `abstract https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerWebSettingsCompat` | `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerControllerCompat#getServiceWorkerWebSettings()()` Gets the settings for all service workers. |
| `abstract https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerControllerCompat#setServiceWorkerClient(androidx.webkit.ServiceWorkerClientCompat)(client: https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerClientCompat?)` Sets the client to capture service worker related callbacks. |

## Public functions

### getInstance

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/webkit#1.1.0)

```
@RequiresFeature(name = WebViewFeature.SERVICE_WORKER_BASIC_USAGE, enforcement = "androidx.webkit.WebViewFeature#isFeatureSupported")
java-static fun getInstance(): ServiceWorkerControllerCompat
```

Returns the default ServiceWorkerController instance. At present there is only one ServiceWorkerController instance for all WebView instances, however this restriction may be relaxed in the future.

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerControllerCompat` | the default ServiceWorkerController instance |

| Throws |
|---|---|
| `https://developer.android.com/reference/java/lang/UnsupportedOperationException.html` | if the `https://developer.android.com/reference/kotlin/androidx/webkit/WebViewFeature#SERVICE_WORKER_BASIC_USAGE()` feature is not supported. This should be checked before use with `https://developer.android.com/reference/kotlin/androidx/webkit/WebViewFeature#isFeatureSupported(java.lang.String)`. |

### getServiceWorkerWebSettings

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/webkit#1.1.0)

```
abstract fun getServiceWorkerWebSettings(): ServiceWorkerWebSettingsCompat
```

Gets the settings for all service workers.

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerWebSettingsCompat` | the current `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerWebSettingsCompat` |

### setServiceWorkerClient

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/webkit#1.1.0)

```
abstract fun setServiceWorkerClient(client: ServiceWorkerClientCompat?): Unit
```

Sets the client to capture service worker related callbacks.

A `https://developer.android.com/reference/kotlin/androidx/webkit/ServiceWorkerClientCompat` should be set before any service workers are active, e.g. a safe place is before any WebView instances are created or pages loaded.