get-reverse-iterating-array
A function returning an array whose iteration direction is reversed without affecting the original array or affecting the iteration direction of any other arrays.
By default, the iteration protocols are defined to iterate on an iterable object’s elements according to their insertion order.
The function getReverseIteratingArray
returns a new Proxy
object with the array being its target. The array’s [Symbol.iterator]
property is trapped in order to define custom iteration behaviour. This has the advantage of not changing the implementation of Array.prototype[Symbol.iterator]
directly which would cause the iteration direction of all arrays to be reversed. Using a proxy also avoids unnecessarily copying an array for reverse iteration like Array.prototype.reverse()
would.
If you require to iterate over an array in both forwards and backwards direction, have a look at ReverseIterableArray
.
Links:
See also:
-
ReverseIterableArray
: reverse-iterable-array -
ReverseIterableMap
: reverse-iterable-map -
ReverseIterableSet
: reverse-iterable-set
Table of contents
Installation
npm install get-reverse-iterating-array
Usage
import getReverseIteratingArray from 'get-reverse-iterating-array';
const array = getReverseIteratingArray([1, 2, 3]);
Examples
For some live usage examples, clone the repository and run the following:
npm install
npm run build
npm start
Then, open localhost:8080/examples in a browser.
Tests
In order to run the tests, clone the repository and run the following:
npm install
npm test
Documentation
Create a reverse-iterating array by passing any array to getReverseIteratingArray
.
const reverseIteratingArray = getReverseIteratingArray([5, 4, 1, 2, 3]);
The returned object will behave like a regular built-in array with the exception of all cases involving the iteration protocols. The behaviour of the following concepts will be changed when used together with a reverse-iterating array:
-
for (const element of reverseIteratingArray) { console.log(element) } //> 3 //> 2 //> 1 //> 4 //> 5
-
[...reverseIteratingArray]; //> [ 3, 2, 1, 4, 5 ]
-
Array.from(reverseIteratingArray); //> [ 3, 2, 1, 4, 5 ]
-
const [a, b, c, d, e] = reverseIteratingArray //> a = 3, b = 2, c = 1, d = 4, e = 5