10e769c63966b1b267923ffb9dda1c7accae8885fcfd361a45db12ab848b134644dae88b5b3b7563d4a651eaff8d7a8c6c29fe155980c6aee82b7f6421541c 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. import { OperatorFunction } from '../types';
  2. import { operate } from '../util/lift';
  3. import { createOperatorSubscriber } from './OperatorSubscriber';
  4. /**
  5. * Emits a given value if the source Observable completes without emitting any
  6. * `next` value, otherwise mirrors the source Observable.
  7. *
  8. * <span class="informal">If the source Observable turns out to be empty, then
  9. * this operator will emit a default value.</span>
  10. *
  11. * ![](defaultIfEmpty.png)
  12. *
  13. * `defaultIfEmpty` emits the values emitted by the source Observable or a
  14. * specified default value if the source Observable is empty (completes without
  15. * having emitted any `next` value).
  16. *
  17. * ## Example
  18. *
  19. * If no clicks happen in 5 seconds, then emit 'no clicks'
  20. *
  21. * ```ts
  22. * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';
  23. *
  24. * const clicks = fromEvent(document, 'click');
  25. * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));
  26. * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));
  27. * result.subscribe(x => console.log(x));
  28. * ```
  29. *
  30. * @see {@link empty}
  31. * @see {@link last}
  32. *
  33. * @param defaultValue The default value used if the source
  34. * Observable is empty.
  35. * @return A function that returns an Observable that emits either the
  36. * specified `defaultValue` if the source Observable emits no items, or the
  37. * values emitted by the source Observable.
  38. */
  39. export function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {
  40. return operate((source, subscriber) => {
  41. let hasValue = false;
  42. source.subscribe(
  43. createOperatorSubscriber(
  44. subscriber,
  45. (value) => {
  46. hasValue = true;
  47. subscriber.next(value);
  48. },
  49. () => {
  50. if (!hasValue) {
  51. subscriber.next(defaultValue!);
  52. }
  53. subscriber.complete();
  54. }
  55. )
  56. );
  57. });
  58. }