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

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

import { identity } from "../../function/identity.mjs";
import { negate } from "../../function/negate.mjs";
import { toArray } from "../_internal/toArray.mjs";
import { iteratee } from "../util/iteratee.mjs";
import { isArrayLikeObject } from "../predicate/isArrayLikeObject.mjs";
//#region src/compat/array/takeRightWhile.ts
/**
* Creates a slice of the array with elements taken from the end while the specified predicate is satisfied.
* If no predicate is provided, the identity function is used by default.
* If the array is `null` or `undefined`, returns an empty array.
*
* @template T
* @param array - The array to process.
* @param [predicate] - The condition used to determine elements to include. Can be:
* - A function invoked per iteration.
* - A partial object to match properties.
* - A key-value pair as a tuple.
* - A property key to check for truthy values.
* Defaults to the identity function if not provided.
* @returns A slice of the array with elements taken from the end or an empty array if `array` is `null` or `undefined`.
*
* @example
* // Using a predicate function
* const items = [1, 2, 3, 4, 5];
* const result = takeRightWhile(items, (item) => item > 3);
* console.log(result); // [4, 5]
*
* // Using a partial object
* const items2 = [{ id: 10 }, { id: 20 }, { id: 30 }];
* const result2 = takeRightWhile(items2, { id: 30 });
* console.log(result2); // [{ id: 30 }]
*
* // Using a key-value pair
* const items3 = [{ name: 'Alice' }, { name: 'Bob' }, { name: 'Alice' }];
* const result3 = takeRightWhile(items3, ['name', 'Alice']);
* console.log(result3); // [{ name: 'Alice' }]
*
* // Using a property key
* const items4 = [{ active: false }, { active: true }, { active: true }];
* const result4 = takeRightWhile(items4, 'active');
* console.log(result4); // [{ active: true }, { active: true }]
*
* // No predicate provided
* const items5 = [false, true];
* const result5 = takeRightWhile(items5);
* console.log(result5); // [true]
*
* // null or undefined array
* const result6 = takeRightWhile(null);
* console.log(result6); // []
*/
function takeRightWhile(_array, predicate) {
	if (!isArrayLikeObject(_array)) return [];
	const array = toArray(_array);
	const index = array.findLastIndex(negate(iteratee(predicate ?? identity)));
	return array.slice(index + 1);
}
//#endregion
export { takeRightWhile };