12345678910111213141516171819
  1. import { Observable } from '../Observable';
  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 declare function single<T>(this: Observable<T>, predicate?: (value: T, index: number, source: Observable<T>) => boolean): Observable<T>;