import { OperatorFunction } from '../types'; | |
import { map } from './map'; | |
/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */ | |
export function mapTo<R>(value: R): OperatorFunction<unknown, R>; | |
/** | |
* @deprecated Do not specify explicit type parameters. Signatures with type parameters | |
* that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9, | |
* use {@link map} instead: `map(() => value)`. | |
* */ | |
export function mapTo<T, R>(value: R): OperatorFunction<T, R>; | |
/** | |
* Emits the given constant value on the output Observable every time the source | |
* Observable emits a value. | |
* | |
* <span class="informal">Like {@link map}, but it maps every source value to | |
* the same output value every time.</span> | |
* | |
*  | |
* | |
* Takes a constant `value` as argument, and emits that whenever the source | |
* Observable emits a value. In other words, ignores the actual source value, | |
* and simply uses the emission moment to know when to emit the given `value`. | |
* | |
* ## Example | |
* | |
* Map every click to the string `'Hi'` | |
* | |
* ```ts | |
* import { fromEvent, mapTo } from 'rxjs'; | |
* | |
* const clicks = fromEvent(document, 'click'); | |
* const greetings = clicks.pipe(mapTo('Hi')); | |
* | |
* greetings.subscribe(x => console.log(x)); | |
* ``` | |
* | |
* @see {@link map} | |
* | |
* @param value The value to map each source value to. | |
* @return A function that returns an Observable that emits the given `value` | |
* every time the source Observable emits. | |
* @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. | |
*/ | |
export function mapTo<R>(value: R): OperatorFunction<unknown, R> { | |
return map(() => value); | |
} | |