All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.caoccao.javet.interop.proxy.plugins.JavetProxyPluginList Maven / Gradle / Ivy

Go to download

Javet is Java + V8 (JAVa + V + EighT). It is an awesome way of embedding Node.js and V8 in Java.

There is a newer version: 4.0.0
Show newest version
/*
 * Copyright (c) 2024. caoccao.com Sam Cao
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.caoccao.javet.interop.proxy.plugins;

import com.caoccao.javet.entities.JavetEntityPropertyDescriptor;
import com.caoccao.javet.enums.V8ValueErrorType;
import com.caoccao.javet.exceptions.JavetException;
import com.caoccao.javet.exceptions.V8ErrorTemplate;
import com.caoccao.javet.interfaces.IJavetEntityPropertyDescriptor;
import com.caoccao.javet.interop.V8Runtime;
import com.caoccao.javet.interop.callback.IJavetDirectCallable;
import com.caoccao.javet.interop.callback.JavetCallbackContext;
import com.caoccao.javet.interop.callback.JavetCallbackType;
import com.caoccao.javet.utils.*;
import com.caoccao.javet.values.V8Value;
import com.caoccao.javet.values.reference.IV8ValueArray;
import com.caoccao.javet.values.reference.V8ValueArray;
import com.caoccao.javet.values.reference.V8ValueFunction;
import com.caoccao.javet.values.reference.V8ValueObject;
import com.caoccao.javet.values.reference.builtin.V8ValueBuiltInSymbol;
import com.caoccao.javet.values.virtual.V8VirtualIterator;

import java.util.*;
import java.util.stream.Collectors;
import java.util.stream.IntStream;

/**
 * The type Javet proxy plugin list.
 *
 * @since 3.0.4
 */
@SuppressWarnings("unchecked")
public class JavetProxyPluginList extends BaseJavetProxyPluginSingle> {
    /**
     * The constant NAME.
     *
     * @since 3.0.4
     */
    public static final String NAME = List.class.getName();
    protected static final String AT = "at";
    protected static final String CONCAT = "concat";
    protected static final String COPY_WITHIN = "copyWithin";
    protected static final String ENTRIES = "entries";
    protected static final String ERROR_TARGET_OBJECT_MUST_BE_AN_INSTANCE_OF_LIST =
            "Target object must be an instance of List.";
    protected static final String EVERY = "every";
    protected static final String FILL = "fill";
    protected static final String FILTER = "filter";
    protected static final String FIND = "find";
    protected static final String FIND_INDEX = "findIndex";
    protected static final String FIND_LAST = "findLast";
    protected static final String FIND_LAST_INDEX = "findLastIndex";
    protected static final String FLAT = "flat";
    protected static final String FLAT_MAP = "flatMap";
    protected static final String FOR_EACH = "forEach";
    protected static final String INCLUDES = "includes";
    protected static final String INDEX_OF = "indexOf";
    protected static final String JOIN = "join";
    protected static final String KEYS = "keys";
    protected static final String LAST_INDEX_OF = "lastIndexOf";
    protected static final String LENGTH = "length";
    protected static final String MAP = "map";
    protected static final String POP = "pop";
    protected static final String PUSH = "push";
    protected static final String REDUCE = "reduce";
    protected static final String REDUCE_RIGHT = "reduceRight";
    protected static final String REVERSE = "reverse";
    protected static final String SHIFT = "shift";
    protected static final String SLICE = "slice";
    protected static final String SOME = "some";
    protected static final String SORT = "sort";
    /**
     * The constant DEFAULT_PROXYABLE_METHODS.
     *
     * @since 3.0.4
     */
    protected static final String[] DEFAULT_PROXYABLE_METHODS = new String[]{
            FOR_EACH, INDEX_OF, LAST_INDEX_OF, SORT, TO_STRING};
    protected static final String SPLICE = "splice";
    protected static final String TO_REVERSED = "toReversed";
    protected static final String TO_SORTED = "toSorted";
    protected static final String TO_SPLICED = "toSpliced";
    protected static final String UNSHIFT = "unshift";
    protected static final String VALUES = "values";
    protected static final String WITH = "with";
    private static final JavetProxyPluginList instance = new JavetProxyPluginList();
    /**
     * The proxyable methods.
     *
     * @since 3.0.4
     */
    protected final Set proxyableMethods;

    public JavetProxyPluginList() {
        super();
        proxyableMethods = SimpleSet.of(DEFAULT_PROXYABLE_METHODS);
        proxyGetByStringMap.put(AT, this::at);
        proxyGetByStringMap.put(CONCAT, this::concat);
        proxyGetByStringMap.put(COPY_WITHIN, this::copyWithin);
        proxyGetByStringMap.put(ENTRIES, this::entries);
        proxyGetByStringMap.put(EVERY, this::every);
        proxyGetByStringMap.put(FILL, this::fill);
        proxyGetByStringMap.put(FILTER, this::filter);
        proxyGetByStringMap.put(FIND, this::find);
        proxyGetByStringMap.put(FIND_INDEX, this::findIndex);
        proxyGetByStringMap.put(FIND_LAST, this::findLast);
        proxyGetByStringMap.put(FIND_LAST_INDEX, this::findLastIndex);
        proxyGetByStringMap.put(FLAT, this::flat);
        proxyGetByStringMap.put(FLAT_MAP, this::flatMap);
        proxyGetByStringMap.put(FOR_EACH, this::forEach);
        proxyGetByStringMap.put(INCLUDES, this::includes);
        proxyGetByStringMap.put(INDEX_OF, this::indexOf);
        proxyGetByStringMap.put(JOIN, this::join);
        proxyGetByStringMap.put(KEYS, this::keys);
        proxyGetByStringMap.put(LAST_INDEX_OF, this::lastIndexOf);
        proxyGetByStringMap.put(LENGTH, this::length);
        proxyGetByStringMap.put(MAP, this::map);
        proxyGetByStringMap.put(POP, this::pop);
        proxyGetByStringMap.put(PUSH, this::push);
        proxyGetByStringMap.put(REDUCE, this::reduce);
        proxyGetByStringMap.put(REDUCE_RIGHT, this::reduceRight);
        proxyGetByStringMap.put(REVERSE, this::reverse);
        proxyGetByStringMap.put(SHIFT, this::shift);
        proxyGetByStringMap.put(SLICE, this::slice);
        proxyGetByStringMap.put(SOME, this::some);
        proxyGetByStringMap.put(SORT, this::sort);
        proxyGetByStringMap.put(SPLICE, this::splice);
        proxyGetByStringMap.put(TO_JSON, this::toJSON);
        proxyGetByStringMap.put(TO_REVERSED, this::toReversed);
        proxyGetByStringMap.put(TO_SORTED, this::toSorted);
        proxyGetByStringMap.put(TO_SPLICED, this::toSpliced);
        proxyGetByStringMap.put(TO_STRING, this::toString);
        proxyGetByStringMap.put(UNSHIFT, this::unshift);
        proxyGetByStringMap.put(VALUE_OF, this::valueOf);
        proxyGetByStringMap.put(VALUES, this::values);
        proxyGetByStringMap.put(WITH, this::with);
        proxyGetBySymbolMap.put(V8ValueBuiltInSymbol.SYMBOL_PROPERTY_ITERATOR, this::values);
    }

    /**
     * Gets instance.
     *
     * @return the instance
     * @since 3.0.4
     */
    public static JavetProxyPluginList getInstance() {
        return instance;
    }

    /**
     * Polyfill Array.prototype.at().
     * The at() method of Array instances takes an integer value and returns the item at that index,
     * allowing for positive and negative integers. Negative integers count back from the last item in the array.
     * 

* Parameters * index * Zero-based index of the array element to be returned, converted to an integer. * Negative index counts back from the end of the array — if index < 0, index + array.length is accessed. *

* Return value * The element in the array matching the given index. * Always returns undefined if index < -array.length or index >= array.length * without attempting to access the corresponding property. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value at(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( AT, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { final int length = list.size(); int index = V8ValueUtils.asInt(v8Values, 0); if (index < 0) { index += length; } if (index >= 0 && index < length) { return v8Runtime.toV8Value(list.get(index)); } return v8Runtime.createV8ValueUndefined(); })); } /** * Polyfill Array.prototype.concat(). * The concat() method of Array instances is used to merge two or more arrays. * This method does not change the existing arrays, but instead returns a new array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value concat(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( CONCAT, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { List results = new ArrayList<>(list.size()); if (!list.isEmpty()) { results.addAll(list); } if (ArrayUtils.isNotEmpty(v8Values)) { for (V8Value v8Value : v8Values) { if (v8Value instanceof IV8ValueArray) { IV8ValueArray iV8ValueArray = (IV8ValueArray) v8Value; V8Value[] items = new V8Value[iV8ValueArray.getLength()]; if (ArrayUtils.isNotEmpty(items)) { iV8ValueArray.batchGet(items, 0, items.length); Collections.addAll(results, items); } } else { Object object = v8Runtime.toObject(v8Value); if (object instanceof List) { Collections.addAll(results, (List) object); } else if (object != null && object.getClass().isArray()) { ListUtils.addAll(results, object); } else { results.add(v8Value); } } } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.copyWithin(). * The copyWithin() method of Array instances shallow copies part of this array to another location * in the same array and returns this array without modifying its length. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value copyWithin(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( COPY_WITHIN, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { Object[] objects = list.toArray(); if (!list.isEmpty() && ArrayUtils.isNotEmpty(v8Values)) { final int length = list.size(); int targetIndex = V8ValueUtils.asInt(v8Values, 0); if (targetIndex < 0) { targetIndex += length; if (targetIndex < 0) { targetIndex = 0; } } int startIndex = V8ValueUtils.asInt(v8Values, 1); if (startIndex < 0) { startIndex += length; if (startIndex < 0) { startIndex = 0; } } int endIndex = V8ValueUtils.asInt(v8Values, 2); if (endIndex < 0) { endIndex += length; if (endIndex < 0) { endIndex = 0; } } if (endIndex > length) { endIndex = length; } if (endIndex == 0) { endIndex = length; } if (targetIndex < length && startIndex < length && endIndex > startIndex) { if (targetIndex + endIndex - startIndex > length) { endIndex = length + startIndex - targetIndex; } for (int i = startIndex; i < endIndex; ++i) { list.set(targetIndex + i - startIndex, objects[i]); } } } return thisObject; })); } @Override protected V8Value createTargetObject(V8Runtime v8Runtime, Object targetObject) throws JavetException { validateTargetObject(targetObject); return v8Runtime.createV8ValueArray(); } @Override public boolean deleteByObject(Object targetObject, Object propertyKey) { final List list = validateTargetObject(targetObject); if (propertyKey instanceof String) { String propertyName = (String) propertyKey; if (StringUtils.isDigital(propertyName)) { final int index = Integer.parseInt(propertyName); if (index >= 0 && index < list.size()) { list.remove(index); return true; } } } return false; } /** * Polyfill Array.prototype.entries(). * The entries() method of Array instances returns a new array iterator object * that contains the key/value pairs for each index in the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value entries(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); final int length = list.size(); List> entries = IntStream.range(0, length) .mapToObj(i -> SimpleList.of(i, list.get(i))) .collect(Collectors.toList()); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( ENTRIES, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> PROXY_CONVERTER.toV8Value(v8Runtime, new V8VirtualIterator<>(entries.iterator())))); } /** * Polyfill Array.prototype.every(). * The every() method of Array instances tests whether all elements in the array pass the test implemented * by the provided function. It returns a Boolean value. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value every(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( EVERY, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value result = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (!result.asBoolean()) { return v8Runtime.createV8ValueBoolean(false); } } ++index; } return v8Runtime.createV8ValueBoolean(true); } return v8Runtime.createV8ValueBoolean(false); })); } /** * Polyfill Array.prototype.fill() * The fill() method of Array instances changes all elements within a range of indices * in an array to a static value. It returns the modified array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value fill(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FILL, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { if (!list.isEmpty() && ArrayUtils.isNotEmpty(v8Values)) { final int length = list.size(); V8Value v8Value = v8Values[0]; int startIndex = V8ValueUtils.asInt(v8Values, 1); if (startIndex < 0) { startIndex += length; if (startIndex < 0) { startIndex = 0; } } int endIndex = V8ValueUtils.asInt(v8Values, 2); if (endIndex < 0) { endIndex += length; if (endIndex < 0) { endIndex = 0; } } if (endIndex == 0) { endIndex = length; } if (startIndex < length && endIndex > startIndex) { for (int i = startIndex; i < endIndex; ++i) { list.set(i, v8Runtime.toObject(v8Value)); } } } return thisObject; })); } /** * Polyfill Array.prototype.filter(). * The filter() method of Array instances creates a shallow copy of a portion of a given array, * filtered down to just the elements from the given array that pass the test implemented by the provided function. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value filter(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FILTER, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { List results = new ArrayList<>(list.size()); V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value v8ValueResult = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (v8ValueResult.asBoolean()) { results.add(object); } } ++index; } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.find(). * The find() method of Array instances returns the first element in the provided array * that satisfies the provided testing function. If no values satisfy the testing function, undefined is returned. *

* If you need the index of the found element in the array, use findIndex(). * If you need to find the index of a value, use indexOf(). (It's similar to findIndex(), * but checks each element for equality with the value instead of using a testing function.) * If you need to find if a value exists in an array, use includes(). * Again, it checks each element for equality with the value instead of using a testing function. * If you need to find if any element satisfies the provided testing function, use some(). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value find(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FIND, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value result = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (result.asBoolean()) { return v8Runtime.toV8Value(object); } } ++index; } } return v8Runtime.createV8ValueUndefined(); })); } /** * Polyfill Array.prototype.findIndex(). * The findIndex() method of Array instances returns the index of the first element in an array * that satisfies the provided testing function. If no elements satisfy the testing function, -1 is returned. *

* See also the find() method, * which returns the first element that satisfies the testing function (rather than its index). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value findIndex(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FIND_INDEX, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value result = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (result.asBoolean()) { return v8Runtime.createV8ValueInteger(index); } } ++index; } } return v8Runtime.createV8ValueInteger(-1); })); } /** * Polyfill Array.prototype.findLast(). * The findLast() method of Array instances iterates the array in reverse order * and returns the value of the first element that satisfies the provided testing function. * If no elements satisfy the testing function, undefined is returned. *

* If you need to find: *

* the first element that matches, use find(). * the index of the last matching element in the array, use findLastIndex(). * the index of a value, use indexOf(). (It's similar to findIndex(), * but checks each element for equality with the value instead of using a testing function.) * whether a value exists in an array, use includes(). * Again, it checks each element for equality with the value instead of using a testing function. * if any element satisfies the provided testing function, use some(). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value findLast(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FIND_LAST, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = list.size() - 1; ListIterator listIterator = list.listIterator(list.size()); while (listIterator.hasPrevious()) { Object object = listIterator.previous(); try (V8Value result = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (result.asBoolean()) { return v8Runtime.toV8Value(object); } } --index; } } return v8Runtime.createV8ValueUndefined(); })); } /** * Polyfill Array.prototype.findLastIndex(). * The findLastIndex() method of Array instances iterates the array in reverse order * and returns the index of the first element that satisfies the provided testing function. * If no elements satisfy the testing function, -1 is returned. *

* See also the findLast() method, * which returns the value of last element that satisfies the testing function (rather than its index). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value findLastIndex(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FIND_LAST_INDEX, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = list.size() - 1; ListIterator listIterator = list.listIterator(list.size()); while (listIterator.hasPrevious()) { try (V8Value result = v8ValueFunction.call( v8ValueObject, listIterator.previous(), v8Runtime.createV8ValueInteger(index), thisObject)) { if (result.asBoolean()) { return v8Runtime.createV8ValueInteger(index); } } --index; } } return v8Runtime.createV8ValueInteger(-1); })); } /** * Polyfill Array.prototype.flat(). * The flat() method of Array instances creates a new array with all sub-array elements concatenated into * it recursively up to the specified depth. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value flat(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FLAT, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { final int depth = V8ValueUtils.asInt(v8Values, 0, 1); List results = new ArrayList<>(list.size()); ListUtils.flat(results, list, depth); return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.flatMap(). * The flatMap() method of Array instances returns a new array formed by applying a given callback function * to each element of the array, and then flattening the result by one level. * It is identical to a map() followed by a flat() of depth 1 (arr.map(...args).flat()), * but slightly more efficient than calling those two methods separately. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value flatMap(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FLAT_MAP, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { List results = new ArrayList<>(list.size()); try { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { results.add(v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)); ++index; } } try (V8ValueArray v8ValueArray = V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray())) { return (V8ValueArray) v8ValueArray.flat(); } } finally { JavetResourceUtils.safeClose(results); } })); } /** * Polyfill Array.prototype.forEach(). * The forEach() method of Array instances executes a provided function once for each array element. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value forEach(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( FOR_EACH, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value v8ValueResult = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { } ++index; } } return v8Runtime.createV8ValueUndefined(); })); } @Override public Object getByIndex(Object targetObject, int index) { final List list = validateTargetObject(targetObject); if (index >= 0 && index < list.size()) { return list.get(index); } return null; } @Override public String getName() { return NAME; } @Override public Object[] getProxyOwnKeys(Object targetObject) { final List list = validateTargetObject(targetObject); List keys = new ArrayList<>(); IntStream.range(0, list.size()).boxed().forEach(keys::add); keys.add(LENGTH); return keys.toArray(); } @Override public IJavetEntityPropertyDescriptor getProxyOwnPropertyDescriptor(Object targetObject, Object propertyName) { if (propertyName instanceof String) { if (LENGTH.equals(propertyName)) { return new JavetEntityPropertyDescriptor<>(false, false, true); } else { return new JavetEntityPropertyDescriptor<>(true, true, true); } } return new JavetEntityPropertyDescriptor<>(false, false, false); } @Override public boolean hasByObject(Object targetObject, Object propertyKey) { final List list = validateTargetObject(targetObject); if (propertyKey instanceof String) { String propertyName = (String) propertyKey; if (StringUtils.isDigital(propertyName)) { final int index = Integer.parseInt(propertyName); return index >= 0 && index < list.size(); } } return false; } /** * Polyfill Array.prototype.includes(). * The includes() method of Array instances determines whether an array includes a certain value among its entries, * returning true or false as appropriate. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value includes(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( INCLUDES, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { boolean included = false; if (ArrayUtils.isNotEmpty(v8Values)) { Object object = v8Runtime.toObject(v8Values[0]); int fromIndex = V8ValueUtils.asInt(v8Values, 1); final int length = list.size(); if (fromIndex < 0) { fromIndex += length; } if (fromIndex < 0) { fromIndex = 0; } if (fromIndex < length) { included = ListUtils.includes(list, object, fromIndex); } } return v8Runtime.createV8ValueBoolean(included); })); } /** * Polyfill Array.prototype.indexOf(). * The indexOf() method of Array instances returns the first index * at which a given element can be found in the array, or -1 if it is not present. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value indexOf(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( INDEX_OF, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { int index = -1; if (ArrayUtils.isNotEmpty(v8Values)) { Object object = v8Runtime.toObject(v8Values[0]); int fromIndex = V8ValueUtils.asInt(v8Values, 1); final int length = list.size(); if (fromIndex < 0) { fromIndex += length; } if (fromIndex < 0) { fromIndex = 0; } if (fromIndex < length) { index = ListUtils.indexOf(list, object, fromIndex); } } return v8Runtime.createV8ValueInteger(index); })); } @Override public boolean isDeleteSupported(Class targetClass) { return true; } @Override public boolean isHasSupported(Class targetClass) { return true; } @Override public boolean isIndexSupported(Class targetClass) { return true; } @Override public boolean isMethodProxyable(String methodName, Class targetClass) { return proxyableMethods.contains(methodName); } @Override public boolean isOwnKeysSupported(Class targetClass) { return true; } @Override public boolean isProxyable(Class targetClass) { return targetClass != null && List.class.isAssignableFrom(targetClass); } /** * Polyfill Array.prototype.join(). * The join() method of Array instances creates and returns a new string by concatenating all of the elements * in this array, separated by commas or a specified separator string. If the array has only one item, * then that item will be returned without using the separator. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value join(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( JOIN, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { String delimiter = V8ValueUtils.asString(v8Values, 0, StringUtils.EMPTY); String result = list.stream().map(Object::toString).collect(Collectors.joining(delimiter)); return v8Runtime.createV8ValueString(result); })); } /** * Polyfill Array.prototype.keys(). * The keys() method of Array instances returns a new array iterator object * that contains the keys for each index in the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value keys(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( KEYS, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { final int length = list.size(); Object[] indexes = new Object[length]; for (int i = 0; i < length; ++i) { indexes[i] = v8Runtime.createV8ValueInteger(i); } return V8ValueUtils.createV8ValueArray(v8Runtime, indexes); })); } /** * Polyfill Array.prototype.lastIndexOf(). * The lastIndexOf() method of Array instances returns the last index * at which a given element can be found in the array, or -1 if it is not present. * The array is searched backwards, starting at fromIndex. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value lastIndexOf(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( LAST_INDEX_OF, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { int index = -1; if (ArrayUtils.isNotEmpty(v8Values)) { Object object = v8Runtime.toObject(v8Values[0]); final int length = list.size(); int fromIndex = V8ValueUtils.asInt(v8Values, 1, length - 1); if (fromIndex < 0) { fromIndex += length; } if (fromIndex < 0) { fromIndex = length - 1; } if (fromIndex < length) { index = ListUtils.lastIndexOf(list, object, fromIndex); } } return v8Runtime.createV8ValueInteger(index); })); } /** * Polyfill Array.length. * The length data property of an Array instance represents the number of elements in that array. * The value is an unsigned, 32-bit integer that is always numerically greater than the highest index in the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value length(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueInteger(list.size()); } /** * Polyfill Array.prototype.map(). * The map() method of Array instances creates a new array populated with the results of * calling a provided function on every element in the calling array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value map(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( MAP, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { List results = new ArrayList<>(list.size()); try { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { results.add(v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)); ++index; } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); } finally { JavetResourceUtils.safeClose(results); } })); } /** * Polyfill Array.prototype.pop(). * The pop() method of Array instances removes the last element from an array and returns that element. * This method changes the length of the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value pop(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( POP, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { if (list.isEmpty()) { return v8Runtime.createV8ValueUndefined(); } return v8Runtime.toV8Value(ListUtils.pop(list)); })); } /** * Polyfill Array.prototype.push(). * The push() method of Array instances adds the specified elements to the end of an array * and returns the new length of the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value push(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( PUSH, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> v8Runtime.createV8ValueInteger( ListUtils.push(list, V8ValueUtils.toArray(v8Runtime, v8Values))))); } /** * Polyfill Array.prototype.reduce(). * The reduce() method of Array instances executes a user-supplied "reducer" callback function on each element * of the array, in order, passing in the return value from the calculation on the preceding element. * The final result of running the reducer across all elements of the array is a single value. *

* The first time that the callback is run there is no "return value of the previous calculation". * If supplied, an initial value may be used in its place. Otherwise the array element at index 0 is used * as the initial value and iteration starts from the next element (index 1 instead of index 0). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value reduce(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( REDUCE, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8Value initialValue = V8ValueUtils.asV8Value(v8Values, 1); final int length = list.size(); if (initialValue == null) { if (length == 0) { v8Runtime.throwError( V8ValueErrorType.TypeError, V8ErrorTemplate.typeErrorReduceOfEmptyArrayWithNoInitialValue()); } else if (length == 1) { return v8Runtime.toV8Value(list.get(0)); } else { /** * If initialValue is not specified, accumulator is initialized * to the first value in the array, and callbackFn starts executing * with the second value in the array as currentValue. */ V8Value accumulator = v8Runtime.toV8Value(list.get(0)); int index = 0; for (Object object : list) { if (index == 0) { ++index; continue; } V8Value result; try (V8Value currentValue = v8Runtime.toV8Value(object)) { result = v8ValueFunction.call( null, accumulator, currentValue, v8Runtime.createV8ValueInteger(index), thisObject); } finally { JavetResourceUtils.safeClose(accumulator); } accumulator = result; ++index; } return accumulator; } } else { if (length == 0) { return initialValue; } else { V8Value accumulator = initialValue.toClone(); int index = 0; for (Object object : list) { V8Value result; try (V8Value currentValue = v8Runtime.toV8Value(object)) { result = v8ValueFunction.call( null, accumulator, currentValue, v8Runtime.createV8ValueInteger(index), thisObject); } finally { JavetResourceUtils.safeClose(accumulator); } accumulator = result; ++index; } return accumulator; } } } return v8Runtime.createV8ValueUndefined(); })); } /** * Polyfill Array.prototype.reduceRight() * The reduceRight() method of Array instances applies a function against an accumulator and each value * of the array (from right-to-left) to reduce it to a single value. *

* See also Array.prototype.reduce() for left-to-right. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value reduceRight(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( REDUCE, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8Value initialValue = V8ValueUtils.asV8Value(v8Values, 1); final int length = list.size(); if (initialValue == null) { if (length == 0) { v8Runtime.throwError( V8ValueErrorType.TypeError, V8ErrorTemplate.typeErrorReduceOfEmptyArrayWithNoInitialValue()); } else if (length == 1) { return v8Runtime.toV8Value(list.get(0)); } else { /** * If initialValue is not specified, accumulator is initialized * to the first value in the array, and callbackFn starts executing * with the second value in the array as currentValue. */ V8Value accumulator = v8Runtime.toV8Value(list.get(length - 1)); int index = length - 1; ListIterator listIterator = list.listIterator(length); while (listIterator.hasPrevious()) { if (index == length - 1) { listIterator.previous(); --index; continue; } V8Value result; try (V8Value currentValue = v8Runtime.toV8Value(listIterator.previous())) { result = v8ValueFunction.call( null, accumulator, currentValue, v8Runtime.createV8ValueInteger(index), thisObject); } finally { JavetResourceUtils.safeClose(accumulator); } accumulator = result; --index; } return accumulator; } } else { if (length == 0) { return initialValue; } else { V8Value accumulator = initialValue.toClone(); int index = length - 1; ListIterator listIterator = list.listIterator(length); while (listIterator.hasPrevious()) { V8Value result; try (V8Value currentValue = v8Runtime.toV8Value(listIterator.previous())) { result = v8ValueFunction.call( null, accumulator, currentValue, v8Runtime.createV8ValueInteger(index), thisObject); } finally { JavetResourceUtils.safeClose(accumulator); } accumulator = result; --index; } return accumulator; } } } return v8Runtime.createV8ValueUndefined(); })); } /** * Polyfill Array.prototype.reverse(). * The reverse() method of Array instances reverses an array in place and returns the reference to the same array, * the first array element now becoming the last, and the last array element becoming the first. In other words, * elements order in the array will be turned towards the direction opposite to that previously stated. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value reverse(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( REVERSE, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { if (!list.isEmpty()) { Collections.reverse(list); } return thisObject; })); } @Override public boolean setByIndex(Object targetObject, int index, Object value) { final List list = validateTargetObject(targetObject); if (index >= 0 && index < list.size()) { list.set(index, value); return true; } return false; } /** * Polyfill Array.prototype.shift(). * The shift() method of Array instances removes the first element from an array and returns that removed element. * This method changes the length of the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value shift(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( SHIFT, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { if (list.isEmpty()) { return v8Runtime.createV8ValueUndefined(); } return v8Runtime.toV8Value(ListUtils.shift(list)); })); } /** * Polyfill Array.prototype.slice(). * The slice() method of Array instances returns a shallow copy of a portion of an array * into a new array object selected from start to end (end not included) where start * and end represent the index of items in that array. The original array will not be modified. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value slice(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( SLICE, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { List results = new ArrayList<>(); if (!list.isEmpty()) { final int length = list.size(); int startIndex = V8ValueUtils.asInt(v8Values, 0); if (startIndex < 0) { startIndex += length; } if (startIndex < 0) { startIndex = 0; } int endIndex = V8ValueUtils.asInt(v8Values, 1, length); if (endIndex < 0) { endIndex += length; } if (endIndex < 0) { endIndex = 0; } if (endIndex > length) { endIndex = length; } if (startIndex < endIndex) { results.addAll(list.subList(startIndex, endIndex)); } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.some(). * The some() method of Array instances tests whether at least one element in the array passes * the test implemented by the provided function. It returns true if, in the array, * it finds an element for which the provided function returns true; otherwise it returns false. * It doesn't modify the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value some(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( SOME, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunctionWithError(v8Runtime, v8Values, 0); if (v8ValueFunction != null) { V8ValueObject v8ValueObject = V8ValueUtils.asV8ValueObject(v8Values, 1); int index = 0; for (Object object : list) { try (V8Value result = v8ValueFunction.call( v8ValueObject, object, v8Runtime.createV8ValueInteger(index), thisObject)) { if (result.asBoolean()) { return v8Runtime.createV8ValueBoolean(true); } } ++index; } } return v8Runtime.createV8ValueBoolean(false); })); } /** * Polyfill Array.prototype.sort(). * The sort() method of Array instances sorts the elements of an array in place * and returns the reference to the same array, now sorted. * The default sort order is ascending, built upon converting the elements into strings, * then comparing their sequences of UTF-16 code units values. *

* The time and space complexity of the sort cannot be guaranteed as it depends on the implementation. *

* To sort the elements in an array without mutating the original array, use toSorted(). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value sort(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( SORT, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { final int length = list.size(); if (length > 1) { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunction(v8Values, 0); if (v8ValueFunction == null) { list.sort((o1, o2) -> ((Comparator) Comparator.naturalOrder()).compare( String.valueOf(o1), String.valueOf(o2))); } else { try { list.sort((o1, o2) -> { try (V8Value v8Value = v8ValueFunction.call(null, o1, o2)) { return v8Value.asInt(); } catch (JavetException e) { throw new RuntimeException(e); } }); } catch (Throwable t) { v8Runtime.throwError(V8ValueErrorType.Error, t.getMessage()); } } } return thisObject; })); } /** * Polyfill Array.prototype.splice(). * The splice() method of Array instances changes the contents of an array by removing * or replacing existing elements and/or adding new elements in place. *

* To create a new array with a segment removed and/or replaced without mutating the original array, * use toSpliced(). To access part of an array without modifying it, see slice(). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value splice(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( SPLICE, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { List results = new ArrayList<>(); if (ArrayUtils.isNotEmpty(v8Values)) { final int length = list.size(); int startIndex = V8ValueUtils.asInt(v8Values, 0); if (startIndex < 0) { startIndex += length; } if (startIndex < 0) { startIndex = 0; } if (startIndex >= length) { v8Runtime.throwError( V8ValueErrorType.RangeError, V8ErrorTemplate.rangeErrorStartIsOutOfRange(startIndex)); } else { int deleteCount = V8ValueUtils.asInt(v8Values, 1); deleteCount = Math.min(deleteCount, length - startIndex); if (deleteCount > 0) { List subList = list.subList(startIndex, startIndex + deleteCount); results.addAll(subList); subList.clear(); } if (v8Values.length > 2) { List toBeAddedList = new ArrayList<>(); for (int i = 2; i < v8Values.length; ++i) { toBeAddedList.add(v8Runtime.toObject(v8Values[i])); } list.addAll(startIndex, toBeAddedList); } } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill List.toJSON(). * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value toJSON(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( TO_JSON, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> V8ValueUtils.createV8ValueArray(v8Runtime, list.toArray()))); } /** * Polyfill Array.prototype.toReversed(). * The toReversed() method of Array instances is the copying counterpart of the reverse() method. * It returns a new array with the elements in reversed order. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value toReversed(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( TO_REVERSED, targetObject, JavetCallbackType.DirectCallThisAndResult, (IJavetDirectCallable.ThisAndResult) (thisObject, v8Values) -> { List reversedList = new ArrayList<>(list); Collections.reverse(reversedList); return V8ValueUtils.createV8ValueArray(v8Runtime, reversedList.toArray()); })); } /** * Polyfill Array.prototype.toSorted() * The toSorted() method of Array instances is the copying version of the sort() method. * It returns a new array with the elements sorted in ascending order. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value toSorted(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( TO_SORTED, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { List results = new ArrayList<>(list); final int length = list.size(); if (length > 1) { V8ValueFunction v8ValueFunction = V8ValueUtils.asV8ValueFunction(v8Values, 0); if (v8ValueFunction == null) { results.sort((o1, o2) -> ((Comparator) Comparator.naturalOrder()).compare( String.valueOf(o1), String.valueOf(o2))); } else { try { results.sort((o1, o2) -> { try (V8Value v8Value = v8ValueFunction.call(null, o1, o2)) { return v8Value.asInt(); } catch (JavetException e) { throw new RuntimeException(e); } }); } catch (Throwable t) { v8Runtime.throwError(V8ValueErrorType.Error, t.getMessage()); } } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.toSpliced() * The toSpliced() method of Array instances is the copying version of the splice() method. * It returns a new array with some elements removed and/or replaced at a given index. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value toSpliced(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( TO_SPLICED, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { List results = new ArrayList<>(list); if (ArrayUtils.isNotEmpty(v8Values)) { final int length = list.size(); int startIndex = V8ValueUtils.asInt(v8Values, 0); if (startIndex < 0) { startIndex += length; } if (startIndex < 0) { startIndex = 0; } if (startIndex >= length) { v8Runtime.throwError( V8ValueErrorType.RangeError, V8ErrorTemplate.rangeErrorStartIsOutOfRange(startIndex)); } else { int deleteCount = V8ValueUtils.asInt(v8Values, 1); deleteCount = Math.min(deleteCount, length - startIndex); if (deleteCount > 0) { results.subList(startIndex, startIndex + deleteCount).clear(); } if (v8Values.length > 2) { List toBeAddedList = new ArrayList<>(); for (int i = 2; i < v8Values.length; ++i) { toBeAddedList.add(v8Runtime.toObject(v8Values[i])); } results.addAll(startIndex, toBeAddedList); } } } return V8ValueUtils.createV8ValueArray(v8Runtime, results.toArray()); })); } /** * Polyfill Array.prototype.toString() * The toString() method of Array instances returns a string representing the specified array and its elements. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value toString(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( TO_STRING, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { try (V8ValueArray v8ValueArray = V8ValueUtils.createV8ValueArray(v8Runtime, list.toArray())) { return v8Runtime.createV8ValueString(v8ValueArray.toString()); } })); } /** * Polyfill Array.prototype.unshift(). * The unshift() method of Array instances adds the specified elements to the beginning of an array * and returns the new length of the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value unshift(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( UNSHIFT, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> v8Runtime.createV8ValueInteger( ListUtils.unshift(list, V8ValueUtils.toArray(v8Runtime, v8Values))))); } @Override protected List validateTargetObject(Object targetObject) { assert targetObject instanceof List : ERROR_TARGET_OBJECT_MUST_BE_AN_INSTANCE_OF_LIST; return (List) targetObject; } /** * Polyfill Object.prototype.valueOf(). * The valueOf() method of Object instances converts the this value to an object. * This method is meant to be overridden by derived objects for custom type conversion logic. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value valueOf(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( VALUE_OF, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> V8ValueUtils.createV8ValueArray(v8Runtime, list.toArray()))); } /** * Polyfill Array.prototype.values(). * The values() method of Array instances returns a new array iterator object that iterates the value * of each item in the array. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value values(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( VALUES, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> PROXY_CONVERTER.toV8Value(v8Runtime, new V8VirtualIterator<>(list.iterator())))); } /** * Polyfill Array.prototype.with(). * The with() method of Array instances is the copying version of using the bracket notation to change the value * of a given index. It returns a new array with the element at the given index replaced with the given value. * * @param v8Runtime the V8 runtime * @param targetObject the target object * @return the V8 value * @throws JavetException the javet exception * @since 3.0.4 */ public V8Value with(V8Runtime v8Runtime, Object targetObject) throws JavetException { final List list = validateTargetObject(targetObject); return Objects.requireNonNull(v8Runtime).createV8ValueFunction(new JavetCallbackContext( WITH, targetObject, JavetCallbackType.DirectCallNoThisAndResult, (IJavetDirectCallable.NoThisAndResult) (v8Values) -> { Object[] objects = list.toArray(); int index = V8ValueUtils.asInt(v8Values, 0); if (index >= 0 && index < objects.length) { objects[index] = v8Values.length > 1 ? v8Values[1] : v8Runtime.createV8ValueUndefined(); } else { v8Runtime.throwError( V8ValueErrorType.RangeError, V8ErrorTemplate.rangeErrorInvalidIndex(index)); } return V8ValueUtils.createV8ValueArray(v8Runtime, objects); })); } }