single.js 985 B

123456789101112131415161718192021
  1. import { single as higherOrder } from '../operators/single';
  2. /**
  3. * Returns an Observable that emits the single item emitted by the source Observable that matches a specified
  4. * predicate, if that Observable emits one such item. If the source Observable emits more than one such item or no
  5. * such items, notify of an IllegalArgumentException or NoSuchElementException respectively.
  6. *
  7. * <img src="./img/single.png" width="100%">
  8. *
  9. * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`
  10. * callback if the Observable completes before any `next` notification was sent.
  11. * @param {Function} predicate - A predicate function to evaluate items emitted by the source Observable.
  12. * @return {Observable<T>} An Observable that emits the single item emitted by the source Observable that matches
  13. * the predicate.
  14. .
  15. * @method single
  16. * @owner Observable
  17. */
  18. export function single(predicate) {
  19. return higherOrder(predicate)(this);
  20. }
  21. //# sourceMappingURL=single.js.map