pluck

Преобразует каждое значение источника в его указанное вложенное свойство.

Примечания по устареванию

Используйте map и необязательное цепное присвоение: pluck('foo', 'bar') является map(x => x?.foo?.bar). Будет удалено в версии 8.

pluck<T, R>(...properties: (string | number | symbol)[]): OperatorFunction<T, R>

Параметры

properties

(string | number | symbol)[]

Вложенные свойства, которые необходимо извлечь из каждого значения источника.

Возвращает

OperatorFunction<T, R>: Функция, возвращающая Observable значений свойств из исходных значений.

Описание

Подобно map, но предназначено только для извлечения одного из вложенных свойств каждого выводимого значения.

Принимая список строк или чисел, описывающих путь к свойству, извлекает значение указанного вложенного свойства из всех значений в исходном Observable. Если свойство не может быть решено, будет возвращено значение undefined для этого значения.

Пример

Сопоставление каждого клика с тегом (tagName) нажатого целевого элемента

import { fromEvent, pluck } from 'rxjs';

const clicks = fromEvent(document, 'click');
const tagNames = clicks.pipe(pluck('target', 'tagName'));

tagNames.subscribe(x => console.log(x));

Перегрузки

pluck(k1: K1): OperatorFunction<T, T[K1]>

Параметры

k1

K1

Возвращает

OperatorFunction<T, T[K1]>

pluck(k1: K1, k2: K2): OperatorFunction<T, T[K1][K2]>

Параметры

k1	K1
k2	K2

Возвращает

OperatorFunction<T, T[K1][K2]>

pluck(k1: K1, k2: K2, k3: K3): OperatorFunction<T, T[K1][K2][K3]>

Параметры

k1	K1
k2	K2
k3	K3

Возвращает

OperatorFunction<T, T[K1][K2][K3]>

pluck(k1: K1, k2: K2, k3: K3, k4: K4): OperatorFunction<T, T[K1][K2][K3][K4]>

Параметры

k1	K1
k2	K2
k3	K3
k4	K4

Возвращает

OperatorFunction<T, T[K1][K2][K3][K4]>

pluck(k1: K1, k2: K2, k3: K3, k4: K4, k5: K5): OperatorFunction<T, T[K1][K2][K3][K4][K5]>

Параметры

k1	K1
k2	K2
k3	K3
k4	K4
k5	K5

Возвращает

OperatorFunction<T, T[K1][K2][K3][K4][K5]>

pluck(k1: K1, k2: K2, k3: K3, k4: K4, k5: K5, k6: K6): OperatorFunction<T, T[K1][K2][K3][K4][K5][K6]>

Параметры

k1	K1
k2	K2
k3	K3
k4	K4
k5	K5
k6	K6

Возвращаемое значение

OperatorFunction<T, T[K1][K2][K3][K4][K5][K6]>

pluck(k1: K1, k2: K2, k3: K3, k4: K4, k5: K5, k6: K6, ...rest: string[]): OperatorFunction<T, unknown>

Параметры

k1	K1
k2	K2
k3	K3
k4	K4
k5	K5
k6	K6
rest	string[]

Возвращаемое значение

OperatorFunction<T, unknown>

pluck(...properties: string[]): OperatorFunction<T, unknown>

Параметры

properties

string[]

Возвращаемое значение

OperatorFunction<T, unknown>

См. также

• map