import { Observable } from '../Observable'; import { SubscribableOrPromise } from '../types'; /** * Decides at subscription time which Observable will actually be subscribed. * * <span class="informal">`If` statement for Observables.</span> * * `iif` accepts a condition function and two Observables. When * an Observable returned by the operator is subscribed, condition function will be called. * Based on what boolean it returns at that moment, consumer will subscribe either to * the first Observable (if condition was true) or to the second (if condition was false). Condition * function may also not return anything - in that case condition will be evaluated as false and * second Observable will be subscribed. * * Note that Observables for both cases (true and false) are optional. If condition points to an Observable that * was left undefined, resulting stream will simply complete immediately. That allows you to, rather * than controlling which Observable will be subscribed, decide at runtime if consumer should have access * to given Observable or not. * * If you have more complex logic that requires decision between more than two Observables, {@link defer} * will probably be a better choice. Actually `iif` can be easily implemented with {@link defer} * and exists only for convenience and readability reasons. * * * ## Examples * ### Change at runtime which Observable will be subscribed * ```ts * import { iif, of } from 'rxjs'; * * let subscribeToFirst; * const firstOrSecond = iif( * () => subscribeToFirst, * of('first'), * of('second'), * ); * * subscribeToFirst = true; * firstOrSecond.subscribe(value => console.log(value)); * * // Logs: * // "first" * * subscribeToFirst = false; * firstOrSecond.subscribe(value => console.log(value)); * * // Logs: * // "second" * * ``` * * ### Control an access to an Observable * ```ts * let accessGranted; * const observableIfYouHaveAccess = iif( * () => accessGranted, * of('It seems you have an access...'), // Note that only one Observable is passed to the operator. * ); * * accessGranted = true; * observableIfYouHaveAccess.subscribe( * value => console.log(value), * err => {}, * () => console.log('The end'), * ); * * // Logs: * // "It seems you have an access..." * // "The end" * * accessGranted = false; * observableIfYouHaveAccess.subscribe( * value => console.log(value), * err => {}, * () => console.log('The end'), * ); * * // Logs: * // "The end" * ``` * * @see {@link defer} * * @param {function(): boolean} condition Condition which Observable should be chosen. * @param {Observable} [trueObservable] An Observable that will be subscribed if condition is true. * @param {Observable} [falseObservable] An Observable that will be subscribed if condition is false. * @return {Observable} Either first or second Observable, depending on condition. * @static true * @name iif * @owner Observable */ export declare function iif<T = never, F = never>(condition: () => boolean, trueResult?: SubscribableOrPromise<T>, falseResult?: SubscribableOrPromise<F>): Observable<T | F>;
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
dom | Folder | 0755 |
|
|
ConnectableObservable.d.ts | File | 907 B | 0644 |
|
ConnectableObservable.js | File | 5.84 KB | 0644 |
|
ConnectableObservable.js.map | File | 3.78 KB | 0644 |
|
SubscribeOnObservable.d.ts | File | 985 B | 0644 |
|
SubscribeOnObservable.js | File | 2.36 KB | 0644 |
|
SubscribeOnObservable.js.map | File | 1.24 KB | 0644 |
|
bindCallback.d.ts | File | 7.31 KB | 0644 |
|
bindCallback.js | File | 3.91 KB | 0644 |
|
bindCallback.js.map | File | 2.76 KB | 0644 |
|
bindNodeCallback.d.ts | File | 7.31 KB | 0644 |
|
bindNodeCallback.js | File | 4.37 KB | 0644 |
|
bindNodeCallback.js.map | File | 3.16 KB | 0644 |
|
combineLatest.d.ts | File | 14.21 KB | 0644 |
|
combineLatest.js | File | 4.28 KB | 0644 |
|
combineLatest.js.map | File | 2.89 KB | 0644 |
|
concat.d.ts | File | 4.77 KB | 0644 |
|
concat.js | File | 436 B | 0644 |
|
concat.js.map | File | 294 B | 0644 |
|
defer.d.ts | File | 2.1 KB | 0644 |
|
defer.js | File | 646 B | 0644 |
|
defer.js.map | File | 554 B | 0644 |
|
empty.d.ts | File | 2 KB | 0644 |
|
empty.js | File | 556 B | 0644 |
|
empty.js.map | File | 522 B | 0644 |
|
forkJoin.d.ts | File | 3.08 KB | 0644 |
|
forkJoin.js | File | 2.65 KB | 0644 |
|
forkJoin.js.map | File | 2.38 KB | 0644 |
|
from.d.ts | File | 404 B | 0644 |
|
from.js | File | 587 B | 0644 |
|
from.js.map | File | 411 B | 0644 |
|
fromArray.d.ts | File | 187 B | 0644 |
|
fromArray.js | File | 551 B | 0644 |
|
fromArray.js.map | File | 364 B | 0644 |
|
fromEvent.d.ts | File | 2.09 KB | 0644 |
|
fromEvent.js | File | 2.7 KB | 0644 |
|
fromEvent.js.map | File | 2.45 KB | 0644 |
|
fromEventPattern.d.ts | File | 557 B | 0644 |
|
fromEventPattern.js | File | 1.28 KB | 0644 |
|
fromEventPattern.js.map | File | 1.03 KB | 0644 |
|
fromIterable.d.ts | File | 189 B | 0644 |
|
fromIterable.js | File | 663 B | 0644 |
|
fromIterable.js.map | File | 444 B | 0644 |
|
fromPromise.d.ts | File | 191 B | 0644 |
|
fromPromise.js | File | 575 B | 0644 |
|
fromPromise.js.map | File | 368 B | 0644 |
|
generate.d.ts | File | 8.94 KB | 0644 |
|
generate.js | File | 3.64 KB | 0644 |
|
generate.js.map | File | 2.83 KB | 0644 |
|
iif.d.ts | File | 3.08 KB | 0644 |
|
iif.js | File | 466 B | 0644 |
|
iif.js.map | File | 367 B | 0644 |
|
interval.d.ts | File | 1.7 KB | 0644 |
|
interval.js | File | 1.04 KB | 0644 |
|
interval.js.map | File | 899 B | 0644 |
|
merge.d.ts | File | 6.45 KB | 0644 |
|
merge.js | File | 1.13 KB | 0644 |
|
merge.js.map | File | 938 B | 0644 |
|
never.d.ts | File | 1.12 KB | 0644 |
|
never.js | File | 321 B | 0644 |
|
never.js.map | File | 248 B | 0644 |
|
of.d.ts | File | 3.22 KB | 0644 |
|
of.js | File | 649 B | 0644 |
|
of.js.map | File | 478 B | 0644 |
|
onErrorResumeNext.d.ts | File | 1.03 KB | 0644 |
|
onErrorResumeNext.js | File | 1.08 KB | 0644 |
|
onErrorResumeNext.js.map | File | 843 B | 0644 |
|
pairs.d.ts | File | 1.97 KB | 0644 |
|
pairs.js | File | 1.59 KB | 0644 |
|
pairs.js.map | File | 1.5 KB | 0644 |
|
partition.d.ts | File | 2.28 KB | 0644 |
|
partition.js | File | 624 B | 0644 |
|
partition.js.map | File | 456 B | 0644 |
|
race.d.ts | File | 2.53 KB | 0644 |
|
race.js | File | 3.3 KB | 0644 |
|
race.js.map | File | 2.06 KB | 0644 |
|
range.d.ts | File | 1.44 KB | 0644 |
|
range.js | File | 1.39 KB | 0644 |
|
range.js.map | File | 1.2 KB | 0644 |
|
throwError.d.ts | File | 1.81 KB | 0644 |
|
throwError.js | File | 645 B | 0644 |
|
throwError.js.map | File | 583 B | 0644 |
|
timer.d.ts | File | 2.16 KB | 0644 |
|
timer.js | File | 1.39 KB | 0644 |
|
timer.js.map | File | 1.2 KB | 0644 |
|
using.d.ts | File | 2.32 KB | 0644 |
|
using.js | File | 1.01 KB | 0644 |
|
using.js.map | File | 849 B | 0644 |
|
zip.d.ts | File | 5.54 KB | 0644 |
|
zip.js | File | 7.82 KB | 0644 |
|
zip.js.map | File | 5.84 KB | 0644 |
|