W3cubDocs

/Angular 12

TransferState

class final

A key value store that is transferred from the application on the server side to the application on the client side.

See more...

class TransferState {
  get<T>(key: StateKey<T>, defaultValue: T): T
  set<T>(key: StateKey<T>, value: T): void
  remove<T>(key: StateKey<T>): void
  hasKey<T>(key: StateKey<T>)
  onSerialize<T>(key: StateKey<T>, callback: () => T): void
  toJson(): string
}

Provided in

Description

TransferState will be available as an injectable token. To use it import ServerTransferStateModule on the server and BrowserTransferStateModule on the client.

The values in the store are serialized/deserialized using JSON.stringify/JSON.parse. So only boolean, number, string, null and non-class objects will be serialized and deserialized in a non-lossy manner.

Methods

Get the value corresponding to a key. Return defaultValue if key is not found.

get<T>(key: StateKey<T>, defaultValue: T): T

Parameters
key StateKey
defaultValue T
Returns

T

Set the value corresponding to a key.

set<T>(key: StateKey<T>, value: T): void

Parameters
key StateKey
value T
Returns

void

Remove a key from the store.

remove<T>(key: StateKey<T>): void

Parameters
key StateKey
Returns

void

Test whether a key exists in the store.

hasKey<T>(key: StateKey<T>)

Parameters
key StateKey

Register a callback to provide the value for a key when toJson is called.

onSerialize<T>(key: StateKey<T>, callback: () => T): void

Parameters
key StateKey
callback () => T
Returns

void

Serialize the current state of the store to JSON.

toJson(): string

Parameters

There are no parameters.

Returns

string

© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v12.angular.io/api/platform-browser/TransferState