import { PartialObserver, ObservableNotification, CompleteNotification, NextNotification, ErrorNotification } from './types';
|
import { Observable } from './Observable';
|
/**
|
* @deprecated Use a string literal instead. `NotificationKind` will be replaced with a type alias in v8.
|
* It will not be replaced with a const enum as those are not compatible with isolated modules.
|
*/
|
export declare enum NotificationKind {
|
NEXT = "N",
|
ERROR = "E",
|
COMPLETE = "C"
|
}
|
/**
|
* Represents a push-based event or value that an {@link Observable} can emit.
|
* This class is particularly useful for operators that manage notifications,
|
* like {@link materialize}, {@link dematerialize}, {@link observeOn}, and
|
* others. Besides wrapping the actual delivered value, it also annotates it
|
* with metadata of, for instance, what type of push message it is (`next`,
|
* `error`, or `complete`).
|
*
|
* @see {@link materialize}
|
* @see {@link dematerialize}
|
* @see {@link observeOn}
|
* @deprecated It is NOT recommended to create instances of `Notification` directly.
|
* Rather, try to create POJOs matching the signature outlined in {@link ObservableNotification}.
|
* For example: `{ kind: 'N', value: 1 }`, `{ kind: 'E', error: new Error('bad') }`, or `{ kind: 'C' }`.
|
* Will be removed in v8.
|
*/
|
export declare class Notification<T> {
|
readonly kind: 'N' | 'E' | 'C';
|
readonly value?: T | undefined;
|
readonly error?: any;
|
/**
|
* A value signifying that the notification will "next" if observed. In truth,
|
* This is really synonymous with just checking `kind === "N"`.
|
* @deprecated Will be removed in v8. Instead, just check to see if the value of `kind` is `"N"`.
|
*/
|
readonly hasValue: boolean;
|
/**
|
* Creates a "Next" notification object.
|
* @param kind Always `'N'`
|
* @param value The value to notify with if observed.
|
* @deprecated Internal implementation detail. Use {@link Notification#createNext createNext} instead.
|
*/
|
constructor(kind: 'N', value?: T);
|
/**
|
* Creates an "Error" notification object.
|
* @param kind Always `'E'`
|
* @param value Always `undefined`
|
* @param error The error to notify with if observed.
|
* @deprecated Internal implementation detail. Use {@link Notification#createError createError} instead.
|
*/
|
constructor(kind: 'E', value: undefined, error: any);
|
/**
|
* Creates a "completion" notification object.
|
* @param kind Always `'C'`
|
* @deprecated Internal implementation detail. Use {@link Notification#createComplete createComplete} instead.
|
*/
|
constructor(kind: 'C');
|
/**
|
* Executes the appropriate handler on a passed `observer` given the `kind` of notification.
|
* If the handler is missing it will do nothing. Even if the notification is an error, if
|
* there is no error handler on the observer, an error will not be thrown, it will noop.
|
* @param observer The observer to notify.
|
*/
|
observe(observer: PartialObserver<T>): void;
|
/**
|
* Executes a notification on the appropriate handler from a list provided.
|
* If a handler is missing for the kind of notification, nothing is called
|
* and no error is thrown, it will be a noop.
|
* @param next A next handler
|
* @param error An error handler
|
* @param complete A complete handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
do(next: (value: T) => void, error: (err: any) => void, complete: () => void): void;
|
/**
|
* Executes a notification on the appropriate handler from a list provided.
|
* If a handler is missing for the kind of notification, nothing is called
|
* and no error is thrown, it will be a noop.
|
* @param next A next handler
|
* @param error An error handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
do(next: (value: T) => void, error: (err: any) => void): void;
|
/**
|
* Executes the next handler if the Notification is of `kind` `"N"`. Otherwise
|
* this will not error, and it will be a noop.
|
* @param next The next handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
do(next: (value: T) => void): void;
|
/**
|
* Executes a notification on the appropriate handler from a list provided.
|
* If a handler is missing for the kind of notification, nothing is called
|
* and no error is thrown, it will be a noop.
|
* @param next A next handler
|
* @param error An error handler
|
* @param complete A complete handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
accept(next: (value: T) => void, error: (err: any) => void, complete: () => void): void;
|
/**
|
* Executes a notification on the appropriate handler from a list provided.
|
* If a handler is missing for the kind of notification, nothing is called
|
* and no error is thrown, it will be a noop.
|
* @param next A next handler
|
* @param error An error handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
accept(next: (value: T) => void, error: (err: any) => void): void;
|
/**
|
* Executes the next handler if the Notification is of `kind` `"N"`. Otherwise
|
* this will not error, and it will be a noop.
|
* @param next The next handler
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
accept(next: (value: T) => void): void;
|
/**
|
* Executes the appropriate handler on a passed `observer` given the `kind` of notification.
|
* If the handler is missing it will do nothing. Even if the notification is an error, if
|
* there is no error handler on the observer, an error will not be thrown, it will noop.
|
* @param observer The observer to notify.
|
* @deprecated Replaced with {@link Notification#observe observe}. Will be removed in v8.
|
*/
|
accept(observer: PartialObserver<T>): void;
|
/**
|
* Returns a simple Observable that just delivers the notification represented
|
* by this Notification instance.
|
*
|
* @deprecated Will be removed in v8. To convert a `Notification` to an {@link Observable},
|
* use {@link of} and {@link dematerialize}: `of(notification).pipe(dematerialize())`.
|
*/
|
toObservable(): Observable<T>;
|
private static completeNotification;
|
/**
|
* A shortcut to create a Notification instance of the type `next` from a
|
* given value.
|
* @param {T} value The `next` value.
|
* @return {Notification<T>} The "next" Notification representing the
|
* argument.
|
* @nocollapse
|
* @deprecated It is NOT recommended to create instances of `Notification` directly.
|
* Rather, try to create POJOs matching the signature outlined in {@link ObservableNotification}.
|
* For example: `{ kind: 'N', value: 1 }`, `{ kind: 'E', error: new Error('bad') }`, or `{ kind: 'C' }`.
|
* Will be removed in v8.
|
*/
|
static createNext<T>(value: T): Notification<T> & NextNotification<T>;
|
/**
|
* A shortcut to create a Notification instance of the type `error` from a
|
* given error.
|
* @param {any} [err] The `error` error.
|
* @return {Notification<T>} The "error" Notification representing the
|
* argument.
|
* @nocollapse
|
* @deprecated It is NOT recommended to create instances of `Notification` directly.
|
* Rather, try to create POJOs matching the signature outlined in {@link ObservableNotification}.
|
* For example: `{ kind: 'N', value: 1 }`, `{ kind: 'E', error: new Error('bad') }`, or `{ kind: 'C' }`.
|
* Will be removed in v8.
|
*/
|
static createError(err?: any): Notification<never> & ErrorNotification;
|
/**
|
* A shortcut to create a Notification instance of the type `complete`.
|
* @return {Notification<any>} The valueless "complete" Notification.
|
* @nocollapse
|
* @deprecated It is NOT recommended to create instances of `Notification` directly.
|
* Rather, try to create POJOs matching the signature outlined in {@link ObservableNotification}.
|
* For example: `{ kind: 'N', value: 1 }`, `{ kind: 'E', error: new Error('bad') }`, or `{ kind: 'C' }`.
|
* Will be removed in v8.
|
*/
|
static createComplete(): Notification<never> & CompleteNotification;
|
}
|
/**
|
* Executes the appropriate handler on a passed `observer` given the `kind` of notification.
|
* If the handler is missing it will do nothing. Even if the notification is an error, if
|
* there is no error handler on the observer, an error will not be thrown, it will noop.
|
* @param notification The notification object to observe.
|
* @param observer The observer to notify.
|
*/
|
export declare function observeNotification<T>(notification: ObservableNotification<T>, observer: PartialObserver<T>): void;
|
//# sourceMappingURL=Notification.d.ts.map
|