Modul util
Gemeinsames Werkzeugmodul
Objekt
LruCache
LRU-Cache-Objekt (zuletzt verwendet), siehe LruCache Objekt.
1LruCache util.LruCache;
Statische Funktion
format
Formatieren Sie die Variablen gemäß dem angegebenen Format
1
2static 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
1static 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
2static 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
2static 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
3static 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).
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
1static 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
2static 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
1static 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
1static 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
1static 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
1static 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
2static 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
2static 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
2static 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
2static 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
1static 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
2static 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
1static 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
2static 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
2static 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
1static 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
1static 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
2static 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
2static 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
2static 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
3static 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
3static 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
4static 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
3static 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
2static 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
1static 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"
}
}