Módulo util

Módulo de herramientas común

Objeto

LruCache

Objeto de caché LRU (menos utilizado recientemente), consulte Objeto LruCache .

1
LruCache util.LruCache;

Función estática

format

Aplicar formato a las variables según el formato especificado

1
2
static String util.format(String fmt,
    ...args);

Parámetros de llamada:

• fmt : Cadena, cadena de formato
• args : ..., lista de parámetros opcionales

Devolver resultado:

• String , devuelve la cadena formateada

Formatear variables

1
static String util.format(...args);

Parámetros de llamada:

• args : ..., lista de parámetros opcionales

Devolver resultado:

• String , devuelve la cadena formateada

inherits

Hereda los métodos de prototipo de un constructor a otro. El prototipo del constructor se establecerá en un nuevo objeto creado a partir del superConstructor.

1
2
static util.inherits(Value constructor,
    Value superConstructor);

Parámetros de llamada:

• constructor : Valor, constructor inicial
• superConstructor : Value, la superConstructor se hereda

inspect

El método devuelve una representación de cadena de obj, que se utiliza principalmente para depurar. Se pueden usar opciones adicionales para cambiar ciertos aspectos de la cadena de formato.

1
2
static String util.inspect(Object obj,
    Object options = {});

Parámetros de llamada:

• obj : Objeto, especifique el objeto a procesar
• options : Objeto, especificar opciones de control de formato

Devolver resultado:

• String , devuelve la cadena formateada

deprecate

Encapsula el método dado, este método solo es compatible y no genera una advertencia

1
2
3
static Function util.deprecate(Function fn,
    String msg,
    String code = "");

Parámetros de llamada:

• fn : Función, dado el método a encapsular
• msg : String, mensaje de advertencia dado
• code : Cadena, número de advertencia dado

Devolver resultado:

• Function , si el resultado está envuelto

isEmpty

Verifique si la variable dada no contiene ningún valor (no hay atributos enumerables)

1
static Boolean util.isEmpty(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si está vacío

isArray

Verifique si la variable dada es una matriz

1
static Boolean util.isArray(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es una matriz

isBoolean

Verifique si la variable dada es booleana

1
static Boolean util.isBoolean(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es booleano

isNull

Verifique si la variable dada es nula

1
static Boolean util.isNull(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve verdadero si es nulo

isNullOrUndefined

Verifique si la variable dada es nula o indefinida

1
static Boolean util.isNullOrUndefined(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es nulo o indefinido

isNumber

Compruebe si la variable dada es un número

1
static Boolean util.isNumber(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un número

isBigInt

Verifique si la variable dada es BigInt

1
static Boolean util.isBigInt(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un número

isString

Verifique si la variable dada es una cadena

1
static Boolean util.isString(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es una cadena

isUndefined

Compruebe si la variable dada no está definida

1
static Boolean util.isUndefined(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve verdadero si no está definido

isRegExp

Verifique si la variable dada es un objeto regular

1
static Boolean util.isRegExp(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto regular

isObject

Verifique si la variable dada es un objeto

1
static Boolean util.isObject(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto

isDate

Verifique si la variable dada es un objeto de fecha

1
static Boolean util.isDate(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto de fecha

isNativeError

Verifique si la variable dada es el objeto incorrecto

1
static Boolean util.isNativeError(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto de error

isPrimitive

Verifique si la variable dada es de tipo primitivo

1
static Boolean util.isPrimitive(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un tipo primitivo

isSymbol

Compruebe si la variable dada es de tipo Símbolo

1
static Boolean util.isSymbol(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo Símbolo

isDataView

Compruebe si la variable dada es de tipo DataView

1
static Boolean util.isDataView(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo DataView

isExternal

Compruebe si la variable dada es de tipo Externo

1
static Boolean util.isExternal(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un tipo externo

isMap

Compruebe si la variable dada es de tipo Mapa

1
static Boolean util.isMap(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un tipo de mapa

isMapIterator

Compruebe si la variable dada es de tipo MapIterator

1
static Boolean util.isMapIterator(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es del tipo MapIterator

isPromise

Verifique si la variable dada es un tipo de promesa

1
static Boolean util.isPromise(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo Promise

isAsyncFunction

Compruebe si la variable dada es de tipo AsyncFunction

1
static Boolean util.isAsyncFunction(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo AsyncFunction

isSet

Compruebe si la variable dada es de tipo Set

1
static Boolean util.isSet(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo Set

isSetIterator

Compruebe si la variable dada es de tipo SetIterator

1
static Boolean util.isSetIterator(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es del tipo SetIterator

isTypedArray

Compruebe si la variable dada es de tipo TypedArray

1
static Boolean util.isTypedArray(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es del tipo TypedArray

isUint8Array

Compruebe si la variable dada es de tipo Uint8Array

1
static Boolean util.isUint8Array(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es de tipo Uint8Array

isFunction

Verifique si la variable dada es un objeto de función

1
static Boolean util.isFunction(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto de función

isBuffer

Compruebe si la variable dada es un objeto Buffer función

1
static Boolean util.isBuffer(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a detectar

Devolver resultado:

• Boolean , devuelve True si es un objeto Buffer función

has

Consultar si el objeto especificado contiene la clave dada

1
2
static Boolean util.has(Value v,
    String key);

Parámetros de llamada:

• v : Valor, dado el objeto a consultar
• key : Cadena, especifique la clave a consultar

Devolver resultado:

• Boolean , devuelve una matriz de todas las claves del objeto.

keys

Consultar todas las matrices de claves del objeto especificado

1
static Array util.keys(Value v);

Parámetros de llamada:

• v : Valor, dado el objeto a consultar

Devolver resultado:

• Array , devuelve una matriz de todas las claves del objeto.

values

Consultar todas las matrices de valores del objeto especificado

1
static Array util.values(Value v);

Parámetros de llamada:

• v : Valor, dado el objeto a consultar

Devolver resultado:

• Array , devuelve una matriz de todos los valores del objeto.

clone

Clona la variable dada, si es un objeto o una matriz, copia el contenido al nuevo objeto

1
static Value util.clone(Value v);

Parámetros de llamada:

• v : Valor, dada la variable a clonar

Devolver resultado:

• Value , devuelve el resultado clonado

deepFreeze

Deep freeze un objeto, el objeto congelado y sus objetos contenidos no podrán ser modificados

1
static util.deepFreeze(Value v);

Parámetros de llamada:

• v : Valor, especifique el objeto a congelar

extend

Extienda el valor clave de uno o más objetos al objeto especificado

1
2
static Value util.extend(Value v,
    ...objs);

Parámetros de llamada:

• v : Valor, especifique el objeto a expandir
• objs : ..., especificar uno o más objetos para la expansión

Devolver resultado:

• Value , devuelve el resultado expandido

_extend

Extienda el valor clave de uno o más objetos al objeto especificado, que es un alias de extender

1
2
static Value util._extend(Value v,
    ...objs);

Parámetros de llamada:

• v : Valor, especifique el objeto a expandir
• objs : ..., especificar uno o más objetos para la expansión

Devolver resultado:

• Value , devuelve el resultado expandido

pick

Devuelve una copia del object , filtrando solo el valor del atributo de la clave especificada

1
2
static Object util.pick(Value v,
    ...objs);

Parámetros de llamada:

• v : Valor, especifique el objeto a filtrar
• objs : ..., especifique una o más claves para la selección

Devolver resultado:

• Object , devuelve el resultado filtrado

omit

Devuelve una copia del object , solo excluyendo el valor de atributo de la clave especificada

1
2
static Object util.omit(Value v,
    ...keys);

Parámetros de llamada:

• v : Valor, especifique el objeto a filtrar
• keys : ..., especifique una o más claves para excluir

Devolver resultado:

• Object , devuelve el resultado excluido

first

Obtenga el primer elemento de la matriz

1
static Value util.first(Value v);

Parámetros de llamada:

• v : Valor, dada la matriz a obtener

Devolver resultado:

• Value , devuelve el elemento obtenido

Obtenga los primeros elementos múltiples de la matriz

1
2
static Value util.first(Value v,
    Integer n);

Parámetros de llamada:

• v : Valor, dada la matriz a obtener
• n : Entero, especifique el número de elementos a obtener

Devolver resultado:

• Value , devuelve la matriz de elementos obtenida

last

Obtenga el primer elemento de la matriz

1
static Value util.last(Value v);

Parámetros de llamada:

• v : Valor, dada la matriz a obtener

Devolver resultado:

• Value , devuelve el elemento obtenido

Obtenga varios elementos al final de la matriz

1
2
static Value util.last(Value v,
    Integer n);

Parámetros de llamada:

• v : Valor, dada la matriz a obtener
• n : Entero, especifique el número de elementos a obtener

Devolver resultado:

• Value , devuelve la matriz de elementos obtenida

unique

Obtenga un duplicado de los elementos de la matriz

1
2
static Array util.unique(Value v,
    Boolean sorted = false);

Parámetros de llamada:

• v : valor, dada la matriz a duplicar
• sorted : booleano, especifica si la matriz está ordenada, si la matriz se especifica para ser ordenada, se utilizará un algoritmo rápido

Devolver resultado:

• Array , devuelve la matriz después de eliminar elementos duplicados

union

Combine los valores de una o más matrices en una matriz con valores únicos

1
static Array util.union(...arrs);

Parámetros de llamada:

• arrs : ..., especifique una o más matrices para fusionar

Devolver resultado:

• Array , devuelve el resultado combinado

intersection

Devuelve la intersección de una matriz que contiene arr y excluye uno o más elementos de la matriz

1
static Array util.intersection(...arrs);

Parámetros de llamada:

• arrs : ..., especifique una o más matrices para calcular la intersección

Devolver resultado:

• Array , devuelve el resultado de calcular la intersección

flatten

Convierta una matriz con varios niveles de anidación (la jerarquización puede ser cualquier nivel) en una matriz con un solo nivel. Si pasa el parámetro superficial, la matriz solo reducirá el anidamiento unidimensional.

1
2
static Array util.flatten(Value arr,
    Boolean shallow = false);

Parámetros de llamada:

• arr : Valor, especifica la matriz a convertir
• shallow : booleano, especifique si desea reducir solo el anidamiento unidimensional, el valor predeterminado es falso

Devolver resultado:

• Array , devuelve el resultado de la conversión.

without

Devuelve una matriz que contiene uno o más elementos de la matriz arr

1
2
static Array util.without(Value arr,
    ...els);

Parámetros de llamada:

• arr : Valor, especifica la matriz a excluir
• els : ..., especifique uno o más elementos para excluir

Devolver resultado:

• Array , devuelve el resultado excluido

difference

Devuelve una matriz que contiene la matriz arr y excluye sin elementos de la matriz

1
2
static Array util.difference(Array list,
    ...arrs);

Parámetros de llamada:

• list : matriz, especifique la matriz que se excluirá
• arrs : ..., especifique una o más matrices para excluir

Devolver resultado:

• Array , devuelve el resultado excluido

each

Recorra todos los elementos de la lista y envíe cada elemento en orden con recorrido. Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Cada llamada al iterador pasará tres parámetros: (elemento, índice, lista)

1
2
3
static Value util.each(Value list,
    Function iterator,
    Value context = undefined);

Parámetros de llamada:

• list : Valor, especifique la lista o el objeto a recorrer
• iterator : función, especifica la función de devolución de llamada utilizada para el recorrido
• context : valor, especifica el objeto de contexto vinculado al llamar al iterador

Devolver resultado:

• Value , devuelve la propia lista

map

Asigne cada valor de la lista a una nueva matriz mediante la función de transformación (iterador). Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Cada llamada al iterador pasará tres parámetros: (elemento, índice, lista)

1
2
3
static Array util.map(Value list,
    Function iterator,
    Value context = undefined);

Parámetros de llamada:

• list : Valor, especifique la lista u objeto a transformar
• iterator : función, especifique la función de devolución de llamada utilizada para la transformación
• context : valor, especifica el objeto de contexto vinculado al llamar al iterador

Devolver resultado:

• Array , devuelve el resultado de la transformación.

reduce

Reducir los elementos de la lista a un solo valor. Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Se pasan tres parámetros cada vez que se llama al iterador: (memo, elemento, índice, lista)

1
2
3
4
static Value util.reduce(Value list,
    Function iterator,
    Value memo,
    Value context = undefined);

Parámetros de llamada:

• list : Valor, especifique la lista u objeto a resolver
• iterator : función, especifica la función de devolución de llamada utilizada para la resolución
• memo : valor, especifique el valor inicial de memo
• context : valor, especifica el objeto de contexto vinculado al llamar al iterador

Devolver resultado:

• Value , devuelve el resultado de la resolución

compile

Compilar script en código binario

1
2
3
static Buffer util.compile(String srcname,
    String script,
    Integer mode = 0);

Parámetros de llamada:

• srcname : String, especifique el nombre del script que se agregará
• script : cadena, especifique el código del script que se compilará
• mode : Entero, modo de compilación, 0: módulo, 1: script, 2: trabajador, el valor predeterminado es 0

Devolver resultado:

• Buffer , devuelve el código binario compilado

util.compile puede compilar scripts en bloques de datos en ejecución internos v8 (código de ejecución que no es de máquina). Una vez que el código compilado se guarda como * .jsc, se puede cargar y ejecutar directamente mediante run y require.

Después de la compilación, el código de destino no podrá obtener el código fuente a la inversa y el programa que depende de Function.toString no se ejecutará normalmente.

sync

Envuelva el método callback o async como una llamada sincrónica

1
2
static Function util.sync(Function func,
    Boolean async_func = false);

Parámetros de llamada:

• func : función, dado el método a envolver
• async_func : booleano, especifique procesar func como función asíncrona, si es falso, se juzgará automáticamente

Devolver resultado:

• Function , devuelve el método para que se ejecute sincrónicamente.

util.sync trata el método de devolución de llamada o el método asíncrono como un método de sincronización para realizar llamadas fácilmente.

El ejemplo de devolución de llamada es el siguiente:

1
2
3
4
5
6
7
8
9
10
11
// callback
var util = require('util');

function cb_test(a, b, cb) {
    setTimeout(() => {
        cb(null, a + b);
    }, 100);
}

var fn_sync = util.sync(cb_test);
console.log(fn_sync(100, 200));

El ejemplo asincrónico es el siguiente:

1
2
3
4
5
6
7
8
9
// async/await
var util = require('util');

async function async_test(a, b) {
    return a + b;
}

var fn_sync = util.sync(async_test);
console.log(fn_sync(100, 200));

Para las funciones que devuelven promesas que no están marcadas como asíncronas, puede especificar manualmente el modo de sincronización:

1
2
3
4
5
6
7
8
9
10
11
// async/await
var util = require('util');

function async_test(a, b) {
    return new Promise(function(resolve, reject) {
        resolve(a + b);
    });
}

var fn_sync = util.sync(async_test, true);
console.log(fn_sync(100, 200));

buildInfo

Consultar información sobre la versión actual del motor y del componente

1
static Object util.buildInfo();

Devolver resultado:

• Object , devuelve el objeto de versión del componente

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "fibjs": "0.25.0",
    "clang": "9.1",
    "date": "Jun 12 2018 07:22:40",
    "vender": {
        "ev": "4.24",
        "expat": "2.2.5",
        "gd": "2.2.4",
        "jpeg": "8.3",
        "leveldb": "1.17",
        "mongo": "0.7",
        "pcre": "8.21",
        "png": "1.5.4",
        "mbedtls": "2.6.1",
        "snappy": "1.1.2",
        "sqlite": "3.23.0",
        "tiff": "3.9.5",
        "uuid": "1.6.2",
        "v8": "6.7.288.20",
        "v8-snapshot": true,
        "zlib": "1.2.7",
        "zmq": "3.1"
    }
}