package Torello.Browser;

import java.util.*;
import javax.json.*;
import javax.json.stream.*;
import java.io.*;

import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.function.Function;

import Torello.Java.Additional.*;
import Torello.Java.JSON.*;

import static Torello.Java.JSON.JFlag.*;

import Torello.Java.StrCmpr;
import Torello.JavaDoc.StaticFunctional;
import Torello.JavaDoc.JDHeaderBackgroundImg;
import Torello.JavaDoc.Excuse;

/**
 * <SPAN CLASS=COPIEDJDK><B>Query and modify DOM storage.</B></SPAN>
 * 
 * <EMBED CLASS='external-html' DATA-FILE-ID=CODE_GEN_NOTE>
 */
@StaticFunctional(Excused={"counter"}, Excuses={Excuse.CONFIGURATION})
@JDHeaderBackgroundImg(EmbedTagFileID="WOOD_PLANK_NOTE")
public class DOMStorage
{
    // ********************************************************************************************
    // ********************************************************************************************
    // Class Header Stuff
    // ********************************************************************************************
    // ********************************************************************************************


    // No Pubic Constructors
    private DOMStorage () { }

    // These two Vector's are used by all the "Methods" exported by this class.  java.lang.reflect
    // is used to generate the JSON String's.  It saves thousands of lines of Auto-Generated Code.
    private static final Map<String, Vector<String>>    parameterNames = new HashMap<>();
    private static final Map<String, Vector<Class<?>>>  parameterTypes = new HashMap<>();

    // Some Methods do not take any parameters - for instance all the "enable()" and "disable()"
    // I simply could not get ride of RAW-TYPES and UNCHECKED warnings... so there are now,
    // offically, two empty-vectors.  One for String's, and the other for Classes.

    private static final Vector<String>     EMPTY_VEC_STR = new Vector<>();
    private static final Vector<Class<?>>   EMPTY_VEC_CLASS = new Vector<>();

    static
    {
        for (Method m : DOMStorage.class.getMethods())
        {
            // This doesn't work!  The parameter names are all "arg0" ... "argN"
            // It works for java.lang.reflect.Field, BUT NOT java.lang.reflect.Parameter!
            //
            // Vector<String> parameterNamesList = new Vector<>(); -- NOPE!

            Vector<Class<?>> parameterTypesList = new Vector<>();
        
            for (Parameter p : m.getParameters()) parameterTypesList.add(p.getType());

            parameterTypes.put(
                m.getName(),
                (parameterTypesList.size() > 0) ? parameterTypesList : EMPTY_VEC_CLASS
            );
        }
    }

    static
    {
        Vector<String> v = null;

        v = new Vector<String>(1);
        parameterNames.put("clear", v);
        Collections.addAll(v, new String[]
        { "storageId", });

        parameterNames.put("disable", EMPTY_VEC_STR);

        parameterNames.put("enable", EMPTY_VEC_STR);

        v = new Vector<String>(1);
        parameterNames.put("getDOMStorageItems", v);
        Collections.addAll(v, new String[]
        { "storageId", });

        v = new Vector<String>(2);
        parameterNames.put("removeDOMStorageItem", v);
        Collections.addAll(v, new String[]
        { "storageId", "key", });

        v = new Vector<String>(3);
        parameterNames.put("setDOMStorageItem", v);
        Collections.addAll(v, new String[]
        { "storageId", "key", "value", });
    }


    // ********************************************************************************************
    // ********************************************************************************************
    // Types - Static Inner Classes
    // ********************************************************************************************
    // ********************************************************************************************

    // public static class Item => String[]
    
    /** DOM Storage identifier. */
    public static class StorageId
        extends BaseType
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** Security origin for the storage. */
        public final String securityOrigin;
        
        /** Whether the storage is local storage (not session storage). */
        public final boolean isLocalStorage;
        
        /**
         * Constructor
         *
         * @param securityOrigin Security origin for the storage.
         * 
         * @param isLocalStorage Whether the storage is local storage (not session storage).
         */
        public StorageId(String securityOrigin, boolean isLocalStorage)
        {
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (securityOrigin == null) BRDPC.throwNPE("securityOrigin");
            
            this.securityOrigin  = securityOrigin;
            this.isLocalStorage  = isLocalStorage;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'StorageId'}.
         */
        public StorageId (JsonObject jo)
        {
            this.securityOrigin  = ReadJSON.getString(jo, "securityOrigin", false, true);
            this.isLocalStorage  = ReadPrimJSON.getBoolean(jo, "isLocalStorage");
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            StorageId o = (StorageId) other;
        
            return
                    Objects.equals(this.securityOrigin, o.securityOrigin)
                &&  (this.isLocalStorage == o.isLocalStorage);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    Objects.hashCode(this.securityOrigin)
                +   (this.isLocalStorage ? 1 : 0);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class domStorageItemAdded
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOMStorage.StorageId storageId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String key;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String newValue;
        
        /**
         * Constructor
         *
         * @param storageId -
         * 
         * @param key -
         * 
         * @param newValue -
         */
        public domStorageItemAdded(DOMStorage.StorageId storageId, String key, String newValue)
        {
            super("DOMStorage", "domStorageItemAdded", 3);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (storageId == null) BRDPC.throwNPE("storageId");
            if (key == null)       BRDPC.throwNPE("key");
            if (newValue == null)  BRDPC.throwNPE("newValue");
            
            this.storageId  = storageId;
            this.key        = key;
            this.newValue   = newValue;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'domStorageItemAdded'}.
         */
        public domStorageItemAdded (JsonObject jo)
        {
            super("DOMStorage", "domStorageItemAdded", 3);
        
            this.storageId  = ReadJSON.getObject(jo, "storageId", DOMStorage.StorageId.class, false, true);
            this.key        = ReadJSON.getString(jo, "key", false, true);
            this.newValue   = ReadJSON.getString(jo, "newValue", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            domStorageItemAdded o = (domStorageItemAdded) other;
        
            return
                    Objects.equals(this.storageId, o.storageId)
                &&  Objects.equals(this.key, o.key)
                &&  Objects.equals(this.newValue, o.newValue);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.storageId.hashCode()
                +   Objects.hashCode(this.key)
                +   Objects.hashCode(this.newValue);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class domStorageItemRemoved
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOMStorage.StorageId storageId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String key;
        
        /**
         * Constructor
         *
         * @param storageId -
         * 
         * @param key -
         */
        public domStorageItemRemoved(DOMStorage.StorageId storageId, String key)
        {
            super("DOMStorage", "domStorageItemRemoved", 2);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (storageId == null) BRDPC.throwNPE("storageId");
            if (key == null)       BRDPC.throwNPE("key");
            
            this.storageId  = storageId;
            this.key        = key;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'domStorageItemRemoved'}.
         */
        public domStorageItemRemoved (JsonObject jo)
        {
            super("DOMStorage", "domStorageItemRemoved", 2);
        
            this.storageId  = ReadJSON.getObject(jo, "storageId", DOMStorage.StorageId.class, false, true);
            this.key        = ReadJSON.getString(jo, "key", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            domStorageItemRemoved o = (domStorageItemRemoved) other;
        
            return
                    Objects.equals(this.storageId, o.storageId)
                &&  Objects.equals(this.key, o.key);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.storageId.hashCode()
                +   Objects.hashCode(this.key);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class domStorageItemUpdated
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, false, false, false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOMStorage.StorageId storageId;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String key;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String oldValue;
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final String newValue;
        
        /**
         * Constructor
         *
         * @param storageId -
         * 
         * @param key -
         * 
         * @param oldValue -
         * 
         * @param newValue -
         */
        public domStorageItemUpdated
            (DOMStorage.StorageId storageId, String key, String oldValue, String newValue)
        {
            super("DOMStorage", "domStorageItemUpdated", 4);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (storageId == null) BRDPC.throwNPE("storageId");
            if (key == null)       BRDPC.throwNPE("key");
            if (oldValue == null)  BRDPC.throwNPE("oldValue");
            if (newValue == null)  BRDPC.throwNPE("newValue");
            
            this.storageId  = storageId;
            this.key        = key;
            this.oldValue   = oldValue;
            this.newValue   = newValue;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'domStorageItemUpdated'}.
         */
        public domStorageItemUpdated (JsonObject jo)
        {
            super("DOMStorage", "domStorageItemUpdated", 4);
        
            this.storageId  = ReadJSON.getObject(jo, "storageId", DOMStorage.StorageId.class, false, true);
            this.key        = ReadJSON.getString(jo, "key", false, true);
            this.oldValue   = ReadJSON.getString(jo, "oldValue", false, true);
            this.newValue   = ReadJSON.getString(jo, "newValue", false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            domStorageItemUpdated o = (domStorageItemUpdated) other;
        
            return
                    Objects.equals(this.storageId, o.storageId)
                &&  Objects.equals(this.key, o.key)
                &&  Objects.equals(this.oldValue, o.oldValue)
                &&  Objects.equals(this.newValue, o.newValue);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.storageId.hashCode()
                +   Objects.hashCode(this.key)
                +   Objects.hashCode(this.oldValue)
                +   Objects.hashCode(this.newValue);
        }
    }
    
    /** <CODE>[No Description Provided by Google]</CODE> */
    public static class domStorageItemsCleared
        extends BrowserEvent
        implements java.io.Serializable
    {
        /** For Object Serialization.  java.io.Serializable */
        protected static final long serialVersionUID = 1;
        
        public boolean[] optionals()
        { return new boolean[] { false, }; }
        
        /** <CODE>[No Description Provided by Google]</CODE> */
        public final DOMStorage.StorageId storageId;
        
        /**
         * Constructor
         *
         * @param storageId -
         */
        public domStorageItemsCleared(DOMStorage.StorageId storageId)
        {
            super("DOMStorage", "domStorageItemsCleared", 1);
            
            // Exception-Check(s) to ensure that if any parameters which are not declared as
            // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
            
            if (storageId == null) BRDPC.throwNPE("storageId");
            
            this.storageId  = storageId;
        }
        
        /**
         * JSON Object Constructor
         * @param jo A Json-Object having data about an instance of {@code 'domStorageItemsCleared'}.
         */
        public domStorageItemsCleared (JsonObject jo)
        {
            super("DOMStorage", "domStorageItemsCleared", 1);
        
            this.storageId  = ReadJSON.getObject(jo, "storageId", DOMStorage.StorageId.class, false, true);
        }
        
        
        /** Checks whether {@code 'this'} equals an input Java-{@code Object} */
        public boolean equals(Object other)
        {
            if (other == null)                       return false;
            if (other.getClass() != this.getClass()) return false;
        
            domStorageItemsCleared o = (domStorageItemsCleared) other;
        
            return
                    Objects.equals(this.storageId, o.storageId);
        }
        
        /** Generates a Hash-Code for {@code 'this'} instance */
        public int hashCode()
        {
            return
                    this.storageId.hashCode();
        }
    }
    
    
    // Counter for keeping the WebSocket Request ID's distinct.
    private static int counter = 1;
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param storageId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> clear(DOMStorage.StorageId storageId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (storageId == null) BRDPC.throwNPE("storageId");
        
        final int       webSocketID = 18000000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("clear"),
            parameterNames.get("clear"),
            optionals, webSocketID,
            "DOMStorage.clear",
            storageId
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Disables storage tracking, prevents storage events from being sent to the client.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> disable()
    {
        final int          webSocketID = 18001000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("disable"),
            parameterNames.get("disable"),
            optionals, webSocketID,
            "DOMStorage.disable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * Enables storage tracking, storage events will now be delivered to the client.
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> enable()
    {
        final int          webSocketID = 18002000 + counter++;
        final boolean[]    optionals   = new boolean[0];
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("enable"),
            parameterNames.get("enable"),
            optionals, webSocketID,
            "DOMStorage.enable"
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param storageId -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * String[][]&gt;</CODE>
     * 
     * <BR /><BR />This <B>script</B> may be <B STYLE='color: red'>executed</B>, using
     * {@link Script#exec()}, and afterwards, a {@link Promise}<CODE>&lt;JsonObject,
     * String[][]&gt;</CODE> will be returned.
     *
     * <BR /><BR />Finally, the <B>{@code Promise}</B> may be <B STYLE='color: red'>awaited</B>,
     * using {@link Promise#await()}, <I>and the returned result of this Browser Function may
      * may be retrieved.</I>
     *
     * <BR /><BR />This Browser Function <B STYLE='color: red'>returns</B>
     * <BR /><BR /><UL CLASS=JDUL>
     * <LI><CODE>String[][] (<B>entries</B></CODE>)
     *     <BR />-
     * </LI>
     * </UL> */
    public static Script<String, JsonObject, String[][]> getDOMStorageItems
        (DOMStorage.StorageId storageId)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (storageId == null) BRDPC.throwNPE("storageId");
        
        final int       webSocketID = 18003000 + counter++;
        final boolean[] optionals   = { false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("getDOMStorageItems"),
            parameterNames.get("getDOMStorageItems"),
            optionals, webSocketID,
            "DOMStorage.getDOMStorageItems",
            storageId
        );
        
        // 'JSON Binding' ... Converts Browser Response-JSON to 'String[][]'
        Function<JsonObject, String[][]> responseProcessor = (JsonObject jo) ->
            (jo.getJsonArray("entries") == null)
                ? null
                : ReadArrJSON.DimN.strArr(jo.getJsonArray("entries"), null, 0, String[][].class);
        
        // Pass the 'defaultSender' to Script-Constructor
        // The sender that is used can be changed before executing script.
        return new Script<>(BRDPC.defaultSender, webSocketID, requestJSON, responseProcessor);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param storageId -
     * 
     * @param key -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> removeDOMStorageItem
        (DOMStorage.StorageId storageId, String key)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (storageId == null) BRDPC.throwNPE("storageId");
        if (key == null)       BRDPC.throwNPE("key");
        
        final int       webSocketID = 18004000 + counter++;
        final boolean[] optionals   = { false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("removeDOMStorageItem"),
            parameterNames.get("removeDOMStorageItem"),
            optionals, webSocketID,
            "DOMStorage.removeDOMStorageItem",
            storageId, key
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
    /**
     * <CODE>[No Description Provided by Google]</CODE>
     * 
     * @param storageId -
     * 
     * @param key -
     * 
     * @param value -
     * 
     * @return An instance of <CODE>{@link Script}&lt;String, {@link JsonObject},
     * {@link Ret0}&gt;</CODE>
     *
     * <BR /><BR />This {@code Script} instance must be <B STYLE='color:red'>executed</B> before the
     * browser receives the invocation-request.
     *
     * <BR /><BR />This Browser-Function <I>does not have</I> a return-value.  You may choose to
     * <B STYLE='color: red'>await</B> the {@link Promise}{@code <JsonObject,} {@link Ret0}
     * {@code >} to ensure the Browser Function has run to completion.
     */
    public static Script<String, JsonObject, Ret0> setDOMStorageItem
        (DOMStorage.StorageId storageId, String key, String value)
    {
        // Exception-Check(s) to ensure that if any parameters which are not declared as
        // 'Optional', but have a 'null' value anyway, that a NullPointerException shall throw.
        
        if (storageId == null) BRDPC.throwNPE("storageId");
        if (key == null)       BRDPC.throwNPE("key");
        if (value == null)     BRDPC.throwNPE("value");
        
        final int       webSocketID = 18005000 + counter++;
        final boolean[] optionals   = { false, false, false, };
        
        // Convert Method Parameters into JSON.  Build the JSON Request-Object (as a String)
        String requestJSON = WriteJSON.get(
            parameterTypes.get("setDOMStorageItem"),
            parameterNames.get("setDOMStorageItem"),
            optionals, webSocketID,
            "DOMStorage.setDOMStorageItem",
            storageId, key, value
        );
        
        // This Remote Command does not have a Return-Value.
        return new Script<>
            (BRDPC.defaultSender, webSocketID, requestJSON, BRDPC.NoReturnValues);
    }
    
}