Documentación RxJS

Subscription

Representa un recurso desechable, como es la ejecución de un Observable. La Suscripción posee un método importante, unsubscribe, que no recibe ningún argumento y se encarga de desechar el recurso que representa la Suscripción

class Subscription implements SubscriptionLike {
static EMPTY: Subscription
constructor(unsubscribe?: () => void)
closed: [object Object]
unsubscribe(): void
add(teardown: TeardownLogic): Subscription
remove(subscription: Subscription): void
}

Subclases

Subscriber

Descripción

Adicionalmente, las suscripciones se pueden agrupar mediante el método add(), que adjunta una Suscripción hija a la Suscripción actual. Cuando se cancela una Suscripción, también se cancela la de todos sus hijos (y nietos.)

Propiedades Estáticas

PropiedadTipoDescripción
EMPTYSubscription

Constructor

constructor()

Firma

constructor(unsubscribe?: () => void)

Parámetros

unsubscribeOpcional. El valor por defecto es undefined. Una función que describe cómo llevar a cabo el desecho de recursos cuando el método unsubscribe es llamado.

Propiedades

PropiedadTipoDescripción
closed[object Object]Indica si la Suscripción ha sido cancelada o no.

Métodos

unsubscribe()
Desecha los recursos representados por la Suscripción. Puede, por ejemplo, cancelar una ejecución Observable o cualquier otro tipo de trabajo que comenzase a partir de la creación de la Suscripción.

Firma

unsubscribe(): void

Parámetros

No recibe ningún parámetro.

Retorna

void:
add()
Añade un teardown que será llamado durante el unsubscribe() de esta Suscripción. También se puede utilizar para añadir una Suscripción hija.

Firma

add(teardown: TeardownLogic): Subscription

Parámetros

teardownLa lógica adicional a ejecutar durante el teardown (proceso de eliminación de recursos.)

Retorna

Subscription: Retorna la Suscripción utilizada o creada para ser añadida a la lista de Suscripciones internas. Esta Suscripción puede utilizarse junto a remove() para eliminar la lógica de teardown proporcionada de la lista de Suscripciones internas.
Si el teardown que se quiere añadir es una Suscripción que ya ha sido cancelada, es la misma referencia que la referencia desde la que se está llamando add o es Subscription.EMPTY, no será añadido.

Si esta Suscripción está en un estado cerrado, la lógica de teardown proporcionada será ejecutada inmediatamente.

Cuando se cancela una Suscripción padre, cualquier Suscripción hija que se le hubiese añadido también se cancela.

remove()
Elimina una Suscripción de la lista interna de Suscripciones que serán canceladas durante el proceso de cancelación de esta Suscripción.

Firma

remove(subscription: Subscription): void

Parámetros

subscriptionLa suscripción a ser eliminada.

Retorna

void:

Recursos adicionales

Source code

Documentación oficial en inglés