👔Array extension

JS ⟩ value ⟩ object⟩ built-in ⟩ Array ⟩ extension

add custom methods to Array.prototype.

💾 程式

• replit ⟩ Array extension

// 2023.01.16 - 22:55 - (+) .maxIn()
// 2022.12.29 - 20:14 - (+) .removeDuplicates(), .union(), .isEmpty
// --------------------------------------------------------------------

const { floor, random } = Math;

// ⭐ Array extension
// --------------------------------------------------------------------
// 🔸 .isEmpty
// 🔸 .randomElement         - random element
// 🔹 .removeDuplicates()    - remove duplicate element (new copy)
// 🔹 .union()               - union with unique elements
// 🔹 .maxIn()               - max quantity in array
// --------------------------------------------------------------------
Object.defineProperties(Array.prototype, {

    // 🔸 .isEmpty
    isEmpty: {
        get() {
            return this.length === 0;
        },
    },
    
    // 🔸 .randomElement
    randomElement: {
        get() {
            return this[floor(random() * this.length)];
        },
    },

    // 🔹 .removeDuplicates()
    removeDuplicates: {
        value: function() {
            return [... new Set(this)];    // new array (non-mutating)
        },
    },

    // 🔹 .union()
    union: {
        value: function(...arrays) {
            return this.concat(...arrays).removeDuplicates(); 
        },
    },

    // 🔹 .maxIn()
    // - max quantity in array
    maxIn: {
        value: function(quantity) {
            return this
                .map(x => quantity(x))
                .reduce((max, value) => max = value > max ? value : max);
        },
    },
    
});

// export
module.exports = {};

💈範例

[].isEmpty,               // true
[1,2,3].randomElement,    // (random)
[ 1, 1, 2, 3, 2, 3, 4 ].removeDuplicates(),  // [ 1, 2, 3, 4 ]
[1].concat([1,2,3],[2,3,4]),                 // [ 1, 1, 2, 3, 2, 3, 4 ]
[1].union([1,2,3],[2,3,4]),                  // [ 1, 2, 3, 4 ]

const touchEvents = ['touchstart', 'touchmove', 'touchend'];
const mouseEvents = ['mousedown', 'mouseup', 'click'];
const eventTypes = [...touchEvents, ...mouseEvents];
eventTypes.maxIn(x => x.length)              // 10

💈其他範例：

• touch event - use array.maxIn(quantity).

🔸 屬性

• arr.isEmpty

• arr.last

• arr.randomElement - random element.

• arr.removeDuplicates() - remove duplicate elements (new copy).