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
Propiedad | Tipo | Descripción |
EMPTY | Subscription |
Constructor
constructor() |
Firma
constructor(unsubscribe?: () => void)
|
Parámetros
unsubscribe | Opcional. 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
Propiedad | Tipo | Descripció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
teardown | La 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
subscription | La suscripción a ser eliminada. |
Retorna
void:
|
Recursos adicionales
Documentación oficial en inglés