max
INFO
이 함수는 호환성을 위한 es-toolkit/compat
에서만 가져올 수 있어요. 대체할 수 있는 네이티브 JavaScript API가 있거나, 아직 충분히 최적화되지 않았기 때문이에요.
es-toolkit/compat
에서 이 함수를 가져오면, lodash와 완전히 똑같이 동작해요.
배열에서 최댓값을 가지는 요소를 반환해요.
배열이 비어 있다면, undefined
를 반환해요.
인터페이스
typescript
function max<T>(items: [T, ...T[]]): T;
function max(): undefined;
function max<T>(items?: ArrayLike<T> | null | undefined): T | undefined;
파라미터
items
(ArrayLike<T> | null | undefined
): 최댓값을 가지는 요소를 찾을 배열이에요.
반환 값
(T | undefined
): 배열에서 최댓값을 가지는 요소. 배열이 비어 있거나, null
, 또는 undefined
인 경우 undefined
를 반환해요.
예시
typescript
max([1, 2, 3]); // Returns: 3
max(['a', 'b']); // Returns: 'b'