Modul util

Gemeinsames Werkzeugmodul

Objekt

LruCache

LRU-Cache-Objekt (zuletzt verwendet), siehe LruCache Objekt.

1
LruCache util.LruCache;

Statische Funktion

format

Formatieren Sie die Variablen gemäß dem angegebenen Format

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

Parameter aufrufen:

• fmt : String, String formatieren
• args : ..., optionale Parameterliste

Ergebnis zurückgeben:

• String , gibt den formatierten String zurück

Formatieren von Variablen

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

Parameter aufrufen:

• args : ..., optionale Parameterliste

Ergebnis zurückgeben:

• String , gibt den formatierten String zurück

inherits

Erben Sie die Prototypmethode von einem Konstruktor zum anderen. Der Prototyp des Konstruktors wird auf ein neues Objekt gesetzt, das aus dem SuperConstructor erstellt wurde.

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

Parameter aufrufen:

• constructor : Wert, anfänglicher Konstruktor
• superConstructor : Wert, wobei die superConstructor geerbt wird

inspect

Die Methode gibt eine Zeichenfolgendarstellung von obj zurück, die hauptsächlich zum Debuggen verwendet wird. Zusätzliche Optionen können verwendet werden, um bestimmte Aspekte der Formatzeichenfolge zu ändern.

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

Parameter aufrufen:

• obj : Objekt, geben Sie das zu verarbeitende Objekt an
• options : Objekt, Formatsteuerungsoptionen angeben

Ergebnis zurückgeben:

• String , gibt den formatierten String zurück

deprecate

Kapselung der angegebenen Methode, diese Methode ist nur kompatibel und gibt keine Warnung aus

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

Parameter aufrufen:

• fn : Funktion bei gegebener zu kapselnder Methode
• msg : String, gegebene Warnmeldung
• code : String, gegebene Warnnummer

Ergebnis zurückgeben:

• Function , wenn das Ergebnis verpackt ist

isEmpty

Überprüfen Sie, ob die angegebene Variable keinen Wert enthält (keine aufzählbaren Attribute).

1
static Boolean util.isEmpty(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es leer ist

isArray

Überprüfen Sie, ob die angegebene Variable ein Array ist

1
static Boolean util.isArray(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um ein Array handelt

isBoolean

Überprüfen Sie, ob die angegebene Variable boolesch ist

1
static Boolean util.isBoolean(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gib True zurück, wenn es Boolean ist

isNull

Überprüfen Sie, ob die angegebene Variable Null ist

1
static Boolean util.isNull(Value v);

Parameter aufrufen:

• v : Wert für die zu erkennende Variable

Ergebnis zurückgeben:

• Boolean , gib True zurück, wenn es Null ist

isNullOrUndefined

Überprüfen Sie, ob die angegebene Variable Null oder Undefiniert ist

1
static Boolean util.isNullOrUndefined(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es Null oder Undefined ist

isNumber

Überprüfen Sie, ob die angegebene Variable eine Zahl ist

1
static Boolean util.isNumber(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um eine Zahl handelt

isBigInt

Überprüfen Sie, ob die angegebene Variable BigInt ist

1
static Boolean util.isBigInt(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um eine Zahl handelt

isString

Überprüfen Sie, ob die angegebene Variable eine Zeichenfolge ist

1
static Boolean util.isString(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um eine Zeichenfolge handelt

isUndefined

Überprüfen Sie, ob die angegebene Variable undefiniert ist

1
static Boolean util.isUndefined(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es undefiniert ist

isRegExp

Überprüfen Sie, ob die angegebene Variable ein reguläres Objekt ist

1
static Boolean util.isRegExp(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um ein reguläres Objekt handelt

isObject

Überprüfen Sie, ob die angegebene Variable ein Objekt ist

1
static Boolean util.isObject(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , return True, wenn es sich um ein Objekt handelt

isDate

Überprüfen Sie, ob die angegebene Variable ein Datumsobjekt ist

1
static Boolean util.isDate(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um ein Datumsobjekt handelt

isNativeError

Überprüfen Sie, ob die angegebene Variable das falsche Objekt ist

1
static Boolean util.isNativeError(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , return True, wenn es sich um ein Fehlerobjekt handelt

isPrimitive

Überprüfen Sie, ob die angegebene Variable vom primitiven Typ ist

1
static Boolean util.isPrimitive(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um einen primitiven Typ handelt

isSymbol

Überprüfen Sie, ob die angegebene Variable vom Typ Symbol ist

1
static Boolean util.isSymbol(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , return True, wenn es vom Typ Symbol ist

isDataView

Überprüfen Sie, ob die angegebene Variable vom Typ DataView ist

1
static Boolean util.isDataView(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Typ DataView ist

isExternal

Überprüfen Sie, ob die angegebene Variable vom Typ Extern ist

1
static Boolean util.isExternal(Value v);

Parameter aufrufen:

• v : Wert für die zu erkennende Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um einen externen Typ handelt

isMap

Überprüfen Sie, ob die angegebene Variable vom Typ Map ist

1
static Boolean util.isMap(Value v);

Parameter aufrufen:

• v : Wert für die zu erkennende Variable

Ergebnis zurückgeben:

• Boolean , geben Sie True zurück, wenn es sich um einen Map-Typ handelt

isMapIterator

Überprüfen Sie, ob die angegebene Variable vom Typ MapIterator ist

1
static Boolean util.isMapIterator(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es sich um einen MapIterator-Typ handelt

isPromise

Überprüfen Sie, ob die angegebene Variable ein Promise-Typ ist

1
static Boolean util.isPromise(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , geben Sie True zurück, wenn es sich um einen Promise-Typ handelt

isAsyncFunction

Überprüfen Sie, ob die angegebene Variable vom Typ AsyncFunction ist

1
static Boolean util.isAsyncFunction(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Typ AsyncFunction ist

isSet

Überprüfen Sie, ob die angegebene Variable vom Typ Set ist

1
static Boolean util.isSet(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Set-Typ ist

isSetIterator

Überprüfen Sie, ob die angegebene Variable vom Typ SetIterator ist

1
static Boolean util.isSetIterator(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Typ SetIterator ist

isTypedArray

Überprüfen Sie, ob die angegebene Variable vom Typ TypedArray ist

1
static Boolean util.isTypedArray(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Typ TypedArray ist

isUint8Array

Überprüfen Sie, ob die angegebene Variable vom Typ Uint8Array ist

1
static Boolean util.isUint8Array(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , gibt True zurück, wenn es vom Typ Uint8Array ist

isFunction

Überprüfen Sie, ob die angegebene Variable ein Funktionsobjekt ist

1
static Boolean util.isFunction(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , return True, wenn es sich um ein Funktionsobjekt handelt

isBuffer

Überprüfen Sie, ob die gegebene Variable eine Funktion Buffer - Objekt

1
static Boolean util.isBuffer(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu erkennender Variable

Ergebnis zurückgeben:

• Boolean , return true , wenn es eine Funktion Buffer - Objekt

has

Fragen Sie ab, ob das angegebene Objekt den angegebenen Schlüssel enthält

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

Parameter aufrufen:

• v : Wert für das abzufragende Objekt
• key : String, geben Sie den abzufragenden Schlüssel an

Ergebnis zurückgeben:

• Boolean , gibt ein Array aller Schlüssel des Objekts zurück

keys

Fragen Sie alle Schlüsselarrays des angegebenen Objekts ab

1
static Array util.keys(Value v);

Parameter aufrufen:

• v : Wert für das abzufragende Objekt

Ergebnis zurückgeben:

• Array , gibt ein Array aller Schlüssel des Objekts zurück

values

Fragen Sie alle Wertearrays des angegebenen Objekts ab

1
static Array util.values(Value v);

Parameter aufrufen:

• v : Wert für das abzufragende Objekt

Ergebnis zurückgeben:

• Array , gibt ein Array aller Werte des Objekts zurück

clone

Klonen Sie die angegebene Variable. Wenn es sich um ein Objekt oder ein Array handelt, kopieren Sie den Inhalt in das neue Objekt

1
static Value util.clone(Value v);

Parameter aufrufen:

• v : Wert bei gegebener zu klonender Variable

Ergebnis zurückgeben:

• Value , geben Sie das geklonte Ergebnis zurück

deepFreeze

Ein Objekt tief einfrieren, das eingefrorene Objekt und die darin enthaltenen Objekte dürfen nicht geändert werden

1
static util.deepFreeze(Value v);

Parameter aufrufen:

• v : Wert: Geben Sie das Objekt an, das eingefroren werden soll

extend

Erweitern Sie den Schlüsselwert eines oder mehrerer Objekte auf das angegebene Objekt

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

Parameter aufrufen:

• v : Wert: Geben Sie das zu erweiternde Objekt an
• objs : ..., geben Sie ein oder mehrere Objekte für die Erweiterung an

Ergebnis zurückgeben:

• Value , gibt das erweiterte Ergebnis zurück

_extend

Erweitern Sie den Schlüsselwert eines oder mehrerer Objekte auf das angegebene Objekt. Dies ist ein Alias ​​für "Erweitern"

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

Parameter aufrufen:

• v : Wert: Geben Sie das zu erweiternde Objekt an
• objs : ..., geben Sie ein oder mehrere Objekte für die Erweiterung an

Ergebnis zurückgeben:

• Value , gibt das erweiterte Ergebnis zurück

pick

Gibt eine Kopie des object und filtert nur den Attributwert des angegebenen Schlüssels heraus

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

Parameter aufrufen:

• v : Wert: Geben Sie das zu filternde Objekt an
• objs : ..., geben Sie einen oder mehrere Schlüssel zur Auswahl an

Ergebnis zurückgeben:

• Object , geben Sie das gefilterte Ergebnis zurück

omit

Geben Sie eine Kopie des object , indem Sie nur den Attributwert des angegebenen Schlüssels ausschließen

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

Parameter aufrufen:

• v : Wert: Geben Sie das zu filternde Objekt an
• keys : ..., geben Sie einen oder mehrere auszuschließende Schlüssel an

Ergebnis zurückgeben:

• Object , geben Sie das ausgeschlossene Ergebnis zurück

first

Holen Sie sich das erste Element des Arrays

1
static Value util.first(Value v);

Parameter aufrufen:

• v : Wert bei gegebenem Array

Ergebnis zurückgeben:

• Value , gibt das erhaltene Element zurück

Holen Sie sich die ersten mehreren Elemente des Arrays

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

Parameter aufrufen:

• v : Wert bei gegebenem Array
• n : Ganzzahl, geben Sie die Anzahl der zu erhaltenden Elemente an

Ergebnis zurückgeben:

• Value , gibt das erhaltene Elementarray zurück

last

Holen Sie sich das erste Element des Arrays

1
static Value util.last(Value v);

Parameter aufrufen:

• v : Wert bei gegebenem Array

Ergebnis zurückgeben:

• Value , gibt das erhaltene Element zurück

Holen Sie sich mehrere Elemente am Ende des Arrays

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

Parameter aufrufen:

• v : Wert bei gegebenem Array
• n : Ganzzahl, geben Sie die Anzahl der zu erhaltenden Elemente an

Ergebnis zurückgeben:

• Value , gibt das erhaltene Elementarray zurück

unique

Holen Sie sich eine Kopie der Elemente des Arrays

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

Parameter aufrufen:

• v : Wert bei gegebenem zu duplizierenden Array
• sorted : Boolescher Wert, geben Sie an, ob das Array sortiert ist oder nicht. Wenn Sie die Arraysortierung angeben, wird ein schneller Algorithmus verwendet

Ergebnis zurückgeben:

• Array , gibt das Array zurück, nachdem doppelte Elemente entfernt wurden

union

Kombinieren Sie die Werte eines oder mehrerer Arrays zu einem Array mit eindeutigen Werten

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

Parameter aufrufen:

• arrs : ..., geben Sie ein oder mehrere Arrays zum Zusammenführen an

Ergebnis zurückgeben:

• Array , gibt das kombinierte Ergebnis zurück

intersection

Gibt den Schnittpunkt eines Arrays zurück, das arr enthält und ein oder mehrere Array-Elemente ausschließt

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

Parameter aufrufen:

• arrs : ..., geben Sie ein oder mehrere Arrays für die Berechnung der Schnittmenge an

Ergebnis zurückgeben:

• Array , gibt das Ergebnis der Berechnung der Schnittmenge zurück

flatten

Konvertieren Sie ein Array mit mehreren Verschachtelungsebenen (Verschachtelung kann eine beliebige Ebene sein) in ein Array mit nur einer Ebene. Wenn Sie den flachen Parameter übergeben, reduziert das Array nur die eindimensionale Verschachtelung.

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

Parameter aufrufen:

• arr : Wert, geben Sie das zu konvertierende Array an
• shallow : Boolescher Wert, geben Sie an, ob nur eindimensionale Verschachtelungen reduziert werden sollen. Der Standardwert ist false

Ergebnis zurückgeben:

• Array , gibt das Ergebnis der Konvertierung zurück

without

Gibt ein Array zurück, das ein oder mehrere Elemente aus dem arr-Array enthält

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

Parameter aufrufen:

• arr : Wert, geben Sie das auszuschließende Array an
• els : ..., geben Sie ein oder mehrere Elemente an, die ausgeschlossen werden sollen

Ergebnis zurückgeben:

• Array , gibt das ausgeschlossene Ergebnis zurück

difference

Gibt ein Array zurück, das das arr-Array enthält und ohne Array-Elemente ausschließt

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

Parameter aufrufen:

• list : Array, geben Sie das auszuschließende Array an
• arrs : ..., geben Sie ein oder mehrere Arrays an, die ausgeschlossen werden sollen

Ergebnis zurückgeben:

• Array , gibt das ausgeschlossene Ergebnis zurück

each

Durchlaufen Sie alle Elemente in der Liste und geben Sie jedes Element nacheinander aus. Wenn der Kontextparameter übergeben wird, ist der Iterator an das Kontextobjekt gebunden. Jeder Aufruf des Iterators übergibt drei Parameter: (Element, Index, Liste)

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

Parameter aufrufen:

• list : Wert, geben Sie die Liste oder das Objekt an, die bzw. das durchlaufen werden soll
• iterator : Funktion: Geben Sie die Rückruffunktion an, die für die Durchquerung verwendet wird
• context : Wert, gibt das Kontextobjekt an, das beim Aufrufen des Iterators gebunden wird

Ergebnis zurückgeben:

• Value , gibt die Liste selbst zurück

map

Ordnen Sie jeden Wert in der Liste über die Transformationsfunktion (Iterator) einem neuen Array zu. Wenn der Kontextparameter übergeben wird, ist der Iterator an das Kontextobjekt gebunden. Jeder Aufruf des Iterators übergibt drei Parameter: (Element, Index, Liste)

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

Parameter aufrufen:

• list : Wert, geben Sie die Liste oder das Objekt an, das transformiert werden soll
• iterator : Funktion: Geben Sie die Rückruffunktion an, die für die Transformation verwendet wird
• context : Wert, gibt das Kontextobjekt an, das beim Aufrufen des Iterators gebunden wird

Ergebnis zurückgeben:

• Array , gibt das Ergebnis der Transformation zurück

reduce

Reduzieren Sie die Elemente in der Liste auf einen einzigen Wert. Wenn der Kontextparameter übergeben wird, ist der Iterator an das Kontextobjekt gebunden. Bei jedem Aufruf des Iterators werden drei Parameter übergeben: (Memo, Element, Index, Liste)

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

Parameter aufrufen:

• list : Wert, geben Sie die Liste oder das Objekt an, die aufgelöst werden sollen
• iterator : Funktion: Geben Sie die Rückruffunktion an, die für die Auflösung verwendet wird
• memo : Wert, geben Sie den Anfangswert der memo
• context : Wert, gibt das Kontextobjekt an, das beim Aufrufen des Iterators gebunden wird

Ergebnis zurückgeben:

• Value , geben Sie das Ergebnis der Auflösung zurück

compile

Kompilieren Sie das Skript in Binärcode

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

Parameter aufrufen:

• srcname : String, geben Sie den Namen des hinzuzufügenden Skripts an
• script : String, geben Sie den zu kompilierenden Skriptcode an
• mode : Ganzzahl, Kompilierungsmodus, 0: Modul, 1: Skript, 2: Worker, der Standardwert ist 0

Ergebnis zurückgeben:

• Buffer , gibt den kompilierten Binärcode zurück

util.compile kann Skripte in interne laufende Datenblöcke der Version util.compile kompilieren (Nicht-Maschinen-Ausführungscode). Nachdem der kompilierte Code als * .jsc gespeichert wurde, kann er direkt von run and require geladen und ausgeführt werden.

Nach der Kompilierung kann der Zielcode den Quellcode nicht umgekehrt abrufen, und das von Function.toString abhängige Programm wird nicht normal ausgeführt.

sync

Schließen Sie die Rückruf- oder Async-Methode als synchronen Aufruf ab

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

Parameter aufrufen:

• func : Funktion bei gegebener Methode
• async_func : Boolean, geben Sie an, dass func als asynchrone Funktion verarbeitet werden soll. Wenn es falsch ist, wird es automatisch beurteilt

Ergebnis zurückgeben:

• Function , gibt die Methode zurück, die synchron ausgeführt werden soll

util.sync behandelt die util.sync oder die asynchrone Methode als Synchronisierungsmethode für den einfachen Aufruf.

Das Rückrufbeispiel lautet wie folgt:

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

Das asynchrone Beispiel lautet wie folgt:

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

Für Funktionen, die Versprechen zurückgeben, die nicht als asynchron markiert sind, können Sie den Synchronisierungsmodus manuell angeben:

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

Fragen Sie die aktuellen Informationen zur Engine und zur Komponentenversion ab

1
static Object util.buildInfo();

Ergebnis zurückgeben:

• Object , gibt das Komponentenversionsobjekt zurück

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