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 { 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): 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): 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; 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} 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(value: T): Notification & NextNotification; /** * A shortcut to create a Notification instance of the type `error` from a * given error. * @param {any} [err] The `error` error. * @return {Notification} 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 & ErrorNotification; /** * A shortcut to create a Notification instance of the type `complete`. * @return {Notification} 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 & 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(notification: ObservableNotification, observer: PartialObserver): void; //# sourceMappingURL=Notification.d.ts.map