Module jdk.scripting.nashorn
Package jdk.nashorn.api.scripting

Class ScriptUtils

  • @Deprecated(since="11",
            forRemoval=true)
public final class ScriptUtils
extends Object
    Deprecated, for removal: This API element is subject to removal in a future version.
    Nashorn JavaScript script engine and APIs, and the jjs tool are deprecated with the intent to remove them in a future release.
    Utilities that are to be called from script code.
    Since:
    1.8u40

    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static Object convert​(Object obj, Object type)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Convert the given object to the given type.
      static String format​(String format, Object[] args)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Method which converts javascript types to java types for the String.format method (jrunscript function sprintf).
      static Object makeSynchronizedFunction​(Object func, Object sync)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Create a wrapper function that calls func synchronized on sync or, if that is undefined, self.
      static String parse​(String code, String name, boolean includeLoc)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns AST as JSON compatible string.
      static Object unwrap​(Object obj)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Unwrap a script object mirror if needed.
      static Object[] unwrapArray​(Object[] args)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Unwrap an array of script object mirrors if needed.
      static ScriptObjectMirror wrap​(Object obj)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Make a script object mirror on given object if needed.
      static Object[] wrapArray​(Object[] args)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Wrap an array of object to script object mirrors if needed.

    • Method Detail

      • parse

        public static String parse​(String code,
                           String name,
                           boolean includeLoc)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Returns AST as JSON compatible string. This is used to implement "parse" function in resources/parse.js script.
        Parameters:
        code - code to be parsed
        name - name of the code source (used for location)
        includeLoc - tells whether to include location information for nodes or not
        Returns:
        JSON string representation of AST of the supplied code

      • format

        public static String format​(String format,
                            Object[] args)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Method which converts javascript types to java types for the String.format method (jrunscript function sprintf).
        Parameters:
        format - a format string
        args - arguments referenced by the format specifiers in format
        Returns:
        a formatted string

      • makeSynchronizedFunction

        public static Object makeSynchronizedFunction​(Object func,
                                              Object sync)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Create a wrapper function that calls func synchronized on sync or, if that is undefined, self. Used to implement "sync" function in resources/mozilla_compat.js.
        Parameters:
        func - the function to wrap
        sync - the object to synchronize on
        Returns:
        a synchronizing wrapper function
        Throws:
        IllegalArgumentException - if func does not represent a script function

      • wrap

        public static ScriptObjectMirror wrap​(Object obj)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Make a script object mirror on given object if needed.
        Parameters:
        obj - object to be wrapped
        Returns:
        wrapped object
        Throws:
        IllegalArgumentException - if obj cannot be wrapped

      • unwrap

        public static Object unwrap​(Object obj)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Unwrap a script object mirror if needed.
        Parameters:
        obj - object to be unwrapped
        Returns:
        unwrapped object

      • wrapArray

        public static Object[] wrapArray​(Object[] args)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Wrap an array of object to script object mirrors if needed.
        Parameters:
        args - array to be unwrapped
        Returns:
        wrapped array

      • unwrapArray

        public static Object[] unwrapArray​(Object[] args)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Unwrap an array of script object mirrors if needed.
        Parameters:
        args - array to be unwrapped
        Returns:
        unwrapped array

      • convert

        public static Object convert​(Object obj,
                             Object type)
        Deprecated, for removal: This API element is subject to removal in a future version.
        Convert the given object to the given type.
        Parameters:
        obj - object to be converted
        type - destination type to convert to. type is either a Class or nashorn representation of a Java type returned by Java.type() call in script.
        Returns:
        converted object