Краткое описание метода
На вход оператора передается список потоков, он на них всех подписывается получает по последнему значению; потом берет значение из родительского потока и соединяет это все в один поток.
Практическое применение
Оператор, чаще всего нужен, чтобы при эмите значения в потоке, получить какие-то данные из другого потока.
Пример схематичный:
hello$.pipe(
withLatestFrom(this.toggleService.isEnabled('some-feature'))
)… то есть - в данном случае, если значение пришло из родительского потока hello$ - оператор withLatestFrom заберет значение из метода сервиса isEnabled и вернет - поток из этих двух значений.
Пример реальный, из эффекта NgRx:
export const saveCounter = createEffect(
() =>
inject(Actions).pipe(
ofType(CounterActions.incrementCounter, CounterActions.decrementCounter),
withLatestFrom(inject(Store).select(countSelect)),
tap(([payload, count]) => {
localStorage.setItem(ECounterStorage.CounterKey, count.toString());
})
),
{ dispatch: false, functional: true }
);… здесь запись ofType(CounterActions.incrementCounter, CounterActions.decrementCounter), трактуется как ИЛИ; то есть, оператор ofType будет фильтровать поток actions$ на экшен incrementCounter или экшен decrementCounter.
Оператор withLatestFrom здесь также - подписан и слушает родительский поток actions$. Если фильтр ofType сработает - из потока actions$ прийдет евент в оператор withLatestFrom, поэтому в свою очередь оператор withLatestFrom заберет значение из потока countSelect, объединит оба значения и вернет новый поток - в евентом, содержащим оба эти значения - ([payload, count]).