Módulo base del módulo

Util del módulo

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 en el formato especificado

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

Parámetros de llamada:

  • fmt : cadena, cadena de formato
  • args : ..., lista de argumentos opcional

Devuelve el resultado:

  • String , devuelve la cadena formateada

Formato formato variable

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

Parámetros de llamada:

  • args : ..., lista de argumentos opcional

Devuelve el resultado:

  • String , devuelve la cadena formateada

inherits

Hereda los métodos 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, el constructor inicial
  • superConstructor : Valor, superclase heredada

inspect

Este método devuelve una representación de cadena de obj, que se utiliza principalmente para la depuración. Se pueden usar opciones adicionales para alterar ciertos aspectos de la cadena formateada.

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

Parámetros de llamada:

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

Devuelve el resultado:

  • String , devuelve la cadena formateada

isEmpty

Detectar si una 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

Devuelve el resultado:

  • Boolean , verdadero si está vacío

isArray

Detecta 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

Devuelve el resultado:

  • Boolean , verdadero si es una matriz

isBoolean

Detectar si la variable dada es booleana

1
static Boolean util.isBoolean(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si es booleano

isNull

Detectar si la variable dada es nula

1
static Boolean util.isNull(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si es nulo

isNullOrUndefined

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si es nulo o indefinido

isNumber

Detectar si una variable dada es un número

1
static Boolean util.isNumber(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si es un número

isBigInt

Detectar si la variable dada es un BigInt

1
static Boolean util.isBigInt(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si es un número

isString

Detecta 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

Devuelve el resultado:

  • Boolean , verdadero si es una cadena

isUndefined

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si no está definido

isRegExp

Detecta 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

Devuelve el resultado:

  • Boolean , devuelve True si es un objeto regular

isObject

Detectar si una variable dada es un objeto

1
static Boolean util.isObject(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si es un objeto

isDate

Detecta 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

Devuelve el resultado:

  • Boolean , verdadero si es un objeto de fecha

isNativeError

Detectar si una variable dada es un objeto de error

1
static Boolean util.isNativeError(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si el objeto es un error

isPrimitive

Detectar si una variable dada es de tipo primitivo

1
static Boolean util.isPrimitive(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si el tipo primitivo

isSymbol

Detectar 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

Devuelve el resultado:

  • Boolean , verdadero si símbolo

isDataView

Comprueba 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

Devuelve el resultado:

  • Boolean , Verdadero si tipo DataView

isExternal

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si externo

isMap

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si es un tipo de Mapa

isMapIterator

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si es un MapIterator

isPromise

Detectar si una variable dada es del tipo Promesa

1
static Boolean util.isPromise(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si tipo de promesa

isAsyncFunction

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si AsyncFunction

isSet

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si es un Conjunto

isSetIterator

Comprueba 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

Devuelve el resultado:

  • Boolean , devuelve True si es un SetIterator

isTypedArray

Comprueba 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

Devuelve el resultado:

  • Boolean , True si TypedArray

isUint8Array

Comprueba 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

Devuelve el resultado:

  • Boolean , verdadero si Uint8Array

isFunction

Detectar si una 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

Devuelve el resultado:

  • Boolean , verdadero si es un objeto de función

isBuffer

Comprueba si la variable dada es un objeto de función Buffer

1
static Boolean util.isBuffer(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a detectar

Devuelve el resultado:

  • Boolean , verdadero si la función es un objeto 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, especifica la clave a consultar

Devuelve el 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

Devuelve el resultado:

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

values

Consultar toda la matriz de valores del objeto especificado

1
static Array util.values(Value v);

Parámetros de llamada:

  • v : Valor, dado el objeto a consultar

Devuelve el resultado:

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

clone

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

1
static Value util.clone(Value v);

Parámetros de llamada:

  • v : Valor, dada la variable a clonar

Devuelve el resultado:

  • Value , devuelve el resultado clonado

deepFreeze

No se permite modificar un objeto congelado, el objeto congelado y los objetos que contiene

1
static util.deepFreeze(Value v);

Parámetros de llamada:

  • v : Valor, especifica 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, especifica el objeto a expandir
  • objs : ..., especifique uno o más objetos para la expansión

Devuelve el resultado:

  • Value , retorno resultado extendido

_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, especifica el objeto a expandir
  • objs : ..., especifique uno o más objetos para la expansión

Devuelve el resultado:

  • Value , retorno resultado extendido

pick

Devuelve una copia del object , filtrando solo los valores de 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

Devuelve el resultado:

  • Object , devolviendo resultados filtrados

omit

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

Devuelve el resultado:

  • Object , devolviendo resultados excluidos

first

Obtenga el primer elemento de una matriz

1
static Value util.first(Value v);

Parámetros de llamada:

  • v : Valor, dada la matriz para obtener

Devuelve el resultado:

  • Value , devuelve el elemento recuperado

Obtenga los primeros elementos múltiples de una matriz

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

Parámetros de llamada:

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

Devuelve el 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 para obtener

Devuelve el resultado:

  • Value , devuelve el elemento recuperado

Obtenga múltiples elementos al final de una matriz

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

Parámetros de llamada:

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

Devuelve el resultado:

  • Value , devuelve la matriz de elementos obtenida

unique

Obtenga copias duplicadas de elementos de matriz

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

Parámetros de llamada:

  • v : Valor, dada la matriz que se deduplicará
  • sorted : Boolean, especifica si la matriz está ordenada. Si la matriz está ordenada, se utilizará un algoritmo rápido

Devuelve el resultado:

  • Array , devuelve la matriz después de la deduplicación

union

Combina los valores de una o más matrices en una matriz única

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

Parámetros de llamada:

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

Devuelve el resultado:

  • Array , devuelve el resultado de la fusión

intersection

Devuelve la intersección de una matriz que contiene arr excluyendo 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

Devuelve el resultado:

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

flatten

Convierte una matriz anidada de varios niveles (la anidación puede ser cualquier número de niveles) en una matriz con solo un nivel. Si pasa el parámetro allow, la matriz reducirá la anidación en solo una dimensión.

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

Parámetros de llamada:

  • arr : Valor, especifica la matriz que se convertirá
  • shallow : booleano, especifique si se reduce solo el anidamiento unidimensional, el valor predeterminado es falso

Devuelve el 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 que se excluirá
  • els : ..., especifique uno o más elementos para excluir

Devuelve el resultado:

  • Array , devolviendo resultados excluidos

difference

Devuelve una matriz que contiene los elementos de matriz excluidos de la matriz arr

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

Devuelve el resultado:

  • Array , devolviendo resultados excluidos

each

Itere a través de todos los elementos de la lista y envíe cada elemento con el recorrido en orden. Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Cada llamada al iterador pasa 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, especifica la lista u objeto a atravesar
  • iterator : Función, especifique una función de devolución de llamada para el recorrido
  • context : Value, especifica el objeto de contexto vinculado cuando se llama al iterador

Devuelve el resultado:

  • Value , lista de retorno en sí

map

Cada función de la lista se asigna a una nueva matriz a través de una función de transformación (iterador iterador). Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. Cada llamada al iterador pasa 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, especifica la lista u objeto a transformar
  • iterator : Función, especifique una función de devolución de llamada para la transformación
  • context : Value, especifica el objeto de contexto vinculado cuando se llama al iterador

Devuelve el resultado:

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

reduce

Los elementos en la lista se reducen a un solo valor. Si se pasa el parámetro de contexto, el iterador está vinculado al objeto de contexto. A cada llamada al iterador se le pasarán 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, especifica la lista u objeto que debe resolverse
  • iterator : Función, especifique una función de devolución de llamada para resolución
  • memo : Value, especifica el valor inicial de la memo
  • context : Value, especifica el objeto de contexto vinculado cuando se llama al iterador

Devuelve el resultado:

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

compile

Compila el 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 : String, especifica 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

Devuelve el resultado:

  • Buffer , devuelve el código binario compilado

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

Debido a que después de la compilación, el código objeto no podrá obtener el código fuente en la dirección inversa, los programas que dependen de Function.toString no se ejecutarán correctamente.


sync

Devolución de llamada o métodos asíncronos para llamadas sincrónicas

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 el uso de la función asíncrona para manejar func, si es falso, se juzgará automáticamente

Devuelve el resultado:

  • Function , devuelve un método que se ejecuta sincrónicamente

util.sync el método de devolución de llamada o el método asíncrono como un método de sincronización para facilitar la invocación.

Un 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));

Un ejemplo de asíncrono es:

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 motor y del componente

1
static Object util.buildInfo();

Devuelve el 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" } }