From e4fa1e69e7ebfb627c7198fd1a9881e9327ec4d4 Mon Sep 17 00:00:00 2001 From: Pinapelz Date: Sat, 28 Jun 2025 17:26:46 -0700 Subject: initial commit: scaffolding --- node_modules/rxjs/src/internal/operators/find.ts | 96 ++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 node_modules/rxjs/src/internal/operators/find.ts (limited to 'node_modules/rxjs/src/internal/operators/find.ts') diff --git a/node_modules/rxjs/src/internal/operators/find.ts b/node_modules/rxjs/src/internal/operators/find.ts new file mode 100644 index 0000000..0697abf --- /dev/null +++ b/node_modules/rxjs/src/internal/operators/find.ts @@ -0,0 +1,96 @@ +import { Observable } from '../Observable'; +import { Subscriber } from '../Subscriber'; +import { OperatorFunction, TruthyTypesOf } from '../types'; +import { operate } from '../util/lift'; +import { createOperatorSubscriber } from './OperatorSubscriber'; + +export function find(predicate: BooleanConstructor): OperatorFunction>; +/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */ +export function find( + predicate: (this: A, value: T, index: number, source: Observable) => value is S, + thisArg: A +): OperatorFunction; +export function find( + predicate: (value: T, index: number, source: Observable) => value is S +): OperatorFunction; +/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */ +export function find( + predicate: (this: A, value: T, index: number, source: Observable) => boolean, + thisArg: A +): OperatorFunction; +export function find(predicate: (value: T, index: number, source: Observable) => boolean): OperatorFunction; +/** + * Emits only the first value emitted by the source Observable that meets some + * condition. + * + * Finds the first value that passes some test and emits + * that. + * + * ![](find.png) + * + * `find` searches for the first item in the source Observable that matches the + * specified condition embodied by the `predicate`, and returns the first + * occurrence in the source. Unlike {@link first}, the `predicate` is required + * in `find`, and does not emit an error if a valid value is not found + * (emits `undefined` instead). + * + * ## Example + * + * Find and emit the first click that happens on a DIV element + * + * ```ts + * import { fromEvent, find } from 'rxjs'; + * + * const div = document.createElement('div'); + * div.style.cssText = 'width: 200px; height: 200px; background: #09c;'; + * document.body.appendChild(div); + * + * const clicks = fromEvent(document, 'click'); + * const result = clicks.pipe(find(ev => (ev.target).tagName === 'DIV')); + * result.subscribe(x => console.log(x)); + * ``` + * + * @see {@link filter} + * @see {@link first} + * @see {@link findIndex} + * @see {@link take} + * + * @param predicate A function called with each item to test for condition matching. + * @param thisArg An optional argument to determine the value of `this` in the + * `predicate` function. + * @return A function that returns an Observable that emits the first item that + * matches the condition. + */ +export function find( + predicate: (value: T, index: number, source: Observable) => boolean, + thisArg?: any +): OperatorFunction { + return operate(createFind(predicate, thisArg, 'value')); +} + +export function createFind( + predicate: (value: T, index: number, source: Observable) => boolean, + thisArg: any, + emit: 'value' | 'index' +) { + const findIndex = emit === 'index'; + return (source: Observable, subscriber: Subscriber) => { + let index = 0; + source.subscribe( + createOperatorSubscriber( + subscriber, + (value) => { + const i = index++; + if (predicate.call(thisArg, value, i, source)) { + subscriber.next(findIndex ? i : value); + subscriber.complete(); + } + }, + () => { + subscriber.next(findIndex ? -1 : undefined); + subscriber.complete(); + } + ) + ); + }; +} -- cgit v1.2.3