isMatch

INFO

이 함수는 호환성을 위한 es-toolkit/compat 에서만 가져올 수 있어요. 대체할 수 있는 네이티브 JavaScript API가 있거나, 아직 충분히 최적화되지 않았기 때문이에요.

es-toolkit/compat에서 이 함수를 가져오면, lodash와 완전히 똑같이 동작해요.

target이 source의 모양 및 값과 일치하는지 확인해요. 객체, 배열, Map, Set의 깊은 비교를 지원해요.

인터페이스

function isMatch(target: unknown, source: unknown): boolean;

파라미터

• target (unknown): 모양과 값이 일치하는지 확인할 값.
• source (unknown): 확인할 모양과 값을 가진 객체.

반환 값

(boolean): target이 source의 모양 및 값과 일치하면 true. 아니면 false.

예시

객체 일치

isMatch({ a: 1, b: 2 }, { a: 1 }); // true

배열 일치

isMatch([1, 2, 3], [1, 2, 3]); // true
isMatch([1, 2, 2, 3], [2, 2]); // true
isMatch([1, 2, 3], [2, 2]); // false

Map 일치

const targetMap = new Map([
  ['key1', 'value1'],
  ['key2', 'value2'],
]);
const sourceMap = new Map([['key1', 'value1']]);
isMatch(targetMap, sourceMap); // true

Set 일치

const targetSet = new Set([1, 2, 3]);
const sourceSet = new Set([1, 2]);
isMatch(targetSet, sourceSet); // true