isMatchWith (Lodash 호환성)

커스텀 비교 함수를 사용해서 객체가 부분적으로 일치하는지 확인해요.

const result = isMatchWith(target, source, customizer);

레퍼런스

isMatchWith(target, source, customizer)

커스텀 비교 로직이 필요할 때 isMatchWith를 사용하세요. 각 프로퍼티 비교에 대해 직접 제어할 수 있어요.

import { isMatchWith } from 'es-toolkit/compat';

// 대소문자 구분 없는 문자열 비교
const caseInsensitiveCompare = (objVal, srcVal) => {
  if (typeof objVal === 'string' && typeof srcVal === 'string') {
    return objVal.toLowerCase() === srcVal.toLowerCase();
  }
  return undefined; // 기본 동작 사용
};

isMatchWith({ name: 'ALICE', age: 25 }, { name: 'alice' }, caseInsensitiveCompare); // true

// 숫자 범위 비교
const rangeCompare = (objVal, srcVal, key) => {
  if (key === 'age' && typeof srcVal === 'object' && srcVal.min !== undefined) {
    return objVal >= srcVal.min && objVal <= srcVal.max;
  }
  return undefined;
};

isMatchWith({ name: 'John', age: 25 }, { age: { min: 18, max: 30 } }, rangeCompare); // true

// 배열 길이 비교
const lengthCompare = (objVal, srcVal, key) => {
  if (key === 'items' && Array.isArray(objVal) && typeof srcVal === 'number') {
    return objVal.length === srcVal;
  }
  return undefined;
};

isMatchWith({ items: ['a', 'b', 'c'], count: 3 }, { items: 3 }, lengthCompare); // true

// 복잡한 조건부 비교
const conditionalCompare = (objVal, srcVal, key, object, source) => {
  // 특정 키에서만 특별한 로직 적용
  if (key === 'status') {
    return srcVal === 'active' || objVal === 'any';
  }

  // 중첩 객체에서 특별한 처리
  if (typeof srcVal === 'object' && srcVal !== null && objVal?.special) {
    return srcVal.id === objVal.special;
  }

  return undefined; // 기본 동작
};

isMatchWith({ user: { special: 123 }, status: 'any' }, { user: { id: 123, status: 'active' } }, conditionalCompare); // true

파라미터

• target (unknown): 일치하는지 확인할 객체예요.
• source (unknown): 일치 패턴이 되는 객체예요.
• customizer (function, 선택): 비교 로직을 커스터마이징하는 함수예요. true, false, 또는 undefined를 반환해야 해요.

반환 값

(boolean): target이 source에 커스텀 로직으로 부분적으로 일치하면 true, 아니면 false를 반환해요.