es-toolkit/dist/compat/array/slice.mjs

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

import { isArrayLike } from "../predicate/isArrayLike.mjs";
import { toInteger } from "../util/toInteger.mjs";
import { isIterateeCall } from "../_internal/isIterateeCall.mjs";
//#region src/compat/array/slice.ts
/**
* Create a slice of `array` from `start` up to, but not including, `end`.
*
* It does not return a dense array for sparse arrays unlike the native `Array.prototype.slice`.
*
* @template T - The type of the array elements.
* @param array - The array to slice.
* @param [start=0] - The start position.
* @param [end=array.length] - The end position.
* @returns Returns the slice of `array`.
*
* @example
* slice([1, 2, 3], 1, 2); // => [2]
* slice(new Array(3)); // => [undefined, undefined, undefined]
*/
function slice(array, start, end) {
	if (!isArrayLike(array)) return [];
	const length = array.length;
	if (end === void 0) end = length;
	else if (typeof end !== "number" && isIterateeCall(array, start, end)) {
		start = 0;
		end = length;
	}
	start = toInteger(start);
	end = toInteger(end);
	if (start < 0) start = Math.max(length + start, 0);
	else start = Math.min(start, length);
	if (end < 0) end = Math.max(length + end, 0);
	else end = Math.min(end, length);
	const resultLength = Math.max(end - start, 0);
	const result = new Array(resultLength);
	for (let i = 0; i < resultLength; ++i) result[i] = array[start + i];
	return result;
}
//#endregion
export { slice };