Módulo módulo básico

Módulo de utilidad

Módulo de herramienta común

Objeto

LruCache

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

1
LruCache util.LruCache;

Función estática

format

Formato de variables de acuerdo con 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

Resultado devuelto:

  • String , devuelve la cadena formateada

Variables de formato

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

Parámetros de llamada:

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

Resultado devuelto:

  • String , devuelve la cadena formateada

inherits

Herede el método 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 : Valor, la superConstructor se hereda

inspect

El método devuelve una representación de cadena de obj, que se utiliza principalmente para la depuración. 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

Resultado devuelto:

  • 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 : Cadena, mensaje de advertencia dado
  • code : Cadena, número de advertencia dado

Resultado devuelto:

  • Function , si el resultado está envuelto

isEmpty

Compruebe si la variable dada no contiene ningún valor (sin atributos enumerables)

1
static Boolean util.isEmpty(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si está vacío

isArray

Compruebe 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

Resultado devuelto:

  • Boolean , devuelve True si es una matriz

isBoolean

Compruebe si la variable dada es booleana

1
static Boolean util.isBoolean(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve verdadero si es booleano

isNull

Compruebe si la variable dada es nula

1
static Boolean util.isNull(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es nulo

isNullOrUndefined

Compruebe 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

Resultado devuelto:

  • 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

Resultado devuelto:

  • Boolean , devuelve True si es un número

isBigInt

Compruebe si la variable dada es BigInt

1
static Boolean util.isBigInt(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es un número

isString

Compruebe 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

Resultado devuelto:

  • 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

Resultado devuelto:

  • Boolean , devuelve True si no está definido

isRegExp

Compruebe 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

Resultado devuelto:

  • Boolean , devuelve True si es un objeto regular

isObject

Compruebe 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

Resultado devuelto:

  • Boolean , devuelve True si es un objeto

isDate

Compruebe 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

Resultado devuelto:

  • Boolean , devuelve True si es un objeto de fecha

isNativeError

Compruebe 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

Resultado devuelto:

  • Boolean , devuelve True si es un objeto de error

isPrimitive

Compruebe 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

Resultado devuelto:

  • 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

Resultado devuelto:

  • Boolean , devuelve True si es de tipo Symbol

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

Resultado devuelto:

  • Boolean , devuelve True si es del 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

Resultado devuelto:

  • Boolean , devuelve True si es un tipo externo

isMap

Compruebe si la variable dada es de tipo Map

1
static Boolean util.isMap(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es de tipo Map

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

Resultado devuelto:

  • Boolean , devuelve True si es del tipo MapIterator

isPromise

Compruebe si la variable dada es del tipo Promesa

1
static Boolean util.isPromise(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es un tipo de Promesa

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

Resultado devuelto:

  • 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

Resultado devuelto:

  • Boolean , devuelve True si es de tipo Set

isSetIterator

Compruebe si la variable dada es del tipo SetIterator

1
static Boolean util.isSetIterator(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es del tipo SetIterator

isTypedArray

Compruebe si la variable dada es del tipo TypedArray

1
static Boolean util.isTypedArray(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es del tipo TypedArray

isUint8Array

Compruebe si la variable dada es del tipo Uint8Array

1
static Boolean util.isUint8Array(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es del tipo Uint8Array

isFunction

Compruebe 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

Resultado devuelto:

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

isBuffer

Compruebe si la variable dada es una función Objeto de Buffer

1
static Boolean util.isBuffer(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Resultado devuelto:

  • Boolean , devuelve True si es una función Objeto de Buffer

has

Consulta 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 : String, especifique la clave a consultar

Resultado devuelto:

  • 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

Resultado devuelto:

  • 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

Resultado devuelto:

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

clone

Clone la variable dada, si es un objeto o una matriz, copie el contenido al nuevo objeto

1
static Value util.clone(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a ser clonada

Resultado devuelto:

  • Value , devuelve el resultado del clon

deepFreeze

No se permite modificar un objeto, el objeto congelado y sus objetos contenidos no se pueden modificar.

1
static util.deepFreeze(Value v);

Parámetros de llamada:

  • v : Valor, especifique el objeto a congelar

extend

Extiende 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 : ..., especifique uno o más objetos para la expansión

Resultado devuelto:

  • Value , devuelve el resultado expandido

_extend

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

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

Parámetros de llamada:

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

Resultado devuelto:

  • 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 teclas para la selección

Resultado devuelto:

  • Object , devuelve el resultado filtrado

omit

Devuelve una copia del object , solo excluyendo el valor del 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

Resultado devuelto:

  • 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 que se obtendrá

Resultado devuelto:

  • 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 que se obtendrá
  • n : Entero, especifique el número de elementos que se obtendrán

Resultado devuelto:

  • Value , devuelve la matriz de elementos obtenida

last

Obtenga el último elemento de la matriz

1
static Value util.last(Value v);

Parámetros de llamada:

  • v : Valor, dada la matriz que se obtendrá

Resultado devuelto:

  • Value , devuelve el elemento obtenido

Obtenga múltiples 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 que se obtendrá
  • n : Entero, especifique el número de elementos que se obtendrán

Resultado devuelto:

  • 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 que se duplicará
  • sorted : Boolean, especifica si la matriz está ordenada, si la matriz está especificada para ser ordenada, se usará un algoritmo rápido

Resultado devuelto:

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

union

Combina 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

Resultado devuelto:

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

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

Resultado devuelto:

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

flatten

Convierta una matriz con múltiples niveles de anidamiento (la anidación puede ser cualquier nivel) en una matriz con solo un 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, especifique la matriz que se convertirá
  • shallow : booleano, especifique si se reduce solo el anidamiento unidimensional, el valor predeterminado es falso

Resultado devuelto:

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

without

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

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

Parámetros de llamada:

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

Resultado devuelto:

  • Array , devuelve el resultado excluido

difference

Devuelve una matriz que contiene la matriz arr y excluye sin elementos de 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

Resultado devuelto:

  • Array , devuelve el resultado excluido

each

Recorre todos los elementos de la lista y genera cada elemento en secuencia. 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: (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 u objeto a atravesar
  • iterator : Función, especifique la función de devolución de llamada utilizada para el recorrido
  • context : Valor, especifique el objeto de contexto vinculado al llamar al iterador

Resultado devuelto:

  • Value , devuelve la lista en sí

map

A través de la función de transformación (iterador), cada valor de la lista se asigna a una nueva matriz. 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: (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, especifique el objeto de contexto vinculado al llamar al iterador

Resultado devuelto:

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

reduce

Reduzca los elementos en la lista a un solo valor. Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Cada llamada al iterador pasará tres parámetros: (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, especifique la función de devolución de llamada utilizada para la resolución
  • memo : Valor, especifique el valor inicial de memo
  • context : Valor, especifique el objeto de contexto vinculado al llamar al iterador

Resultado devuelto:

  • Value , devuelve el resultado de la resolución.

compile

Compilar script para 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 : String, especifique el código del script que se compilará
  • mode : entero, modo de compilación, 0: módulo, 1: secuencia de comandos, 2: trabajador, el valor predeterminado es 0

Resultado devuelto:

  • Buffer , devuelve el código binario compilado

util.compile puede compilar scripts en bloques de datos de ejecución interna v8 (código de ejecución que no es de máquina). El código compilado se puede cargar y ejecutar directamente ejecutando y requerir después de guardarlo como * .jsc.

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 la devolución de llamada o el método asíncrono como una llamada síncrona

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 para procesar func como función asincrónica, si es falso, se juzgará automáticamente

Resultado devuelto:

  • Function , devuelve el método para ejecutarse 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 llamadas convenientes.

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 asíncrono 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 la información actual de la versión del componente y del motor

1
static Object util.buildInfo();

Resultado devuelto:

  • 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" } }