types module

إرجاع true إذا كانت القيمة عبارة عن مثيل ArrayBuffer مضمن أو SharedArrayBuffer.

راجع أيضا util.types.isArrayBuffer()util.types.isSharedArrayBuffer().

util.types.isAnyArrayBuffer(new ArrayBuffer());  // Returns true
util.types.isAnyArrayBuffer(new SharedArrayBuffer());  // Returns true

function isAnyArrayBuffer(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائن arguments.

function foo() {
  util.types.isArgumentsObject(arguments);  // Returns true
}

function isArgumentsObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل ArrayBuffer مضمن. لا يتضمن هذا مثيلات SharedArrayBuffer. عادة ما يكون من المستحسن اختبار كليهما؛ انظر util.types.isAnyArrayBuffer() لذلك.

util.types.isArrayBuffer(new ArrayBuffer());  // Returns true
util.types.isArrayBuffer(new SharedArrayBuffer());  // Returns false

function isArrayBuffer(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مثيلا لإحدى طرق العرض ArrayBuffer، مثل كائنات الصفيف التي تم كتابتها أو DataView. مكافئ ArrayBuffer.isView().

util.types.isArrayBufferView(new Int8Array());  // true
util.types.isArrayBufferView(Buffer.from('hello world')); // true
util.types.isArrayBufferView(new DataView(new ArrayBuffer(16)));  // true
util.types.isArrayBufferView(new ArrayBuffer());  // false

function isArrayBufferView(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة دالة غير متزامنة . هذا فقط تقارير مرة أخرى ما يرى محرك JavaScript; على وجه الخصوص، قد لا تتطابق القيمة المرجعة مع التعليمات البرمجية المصدر الأصلية إذا تم استخدام أداة تبديل.

util.types.isAsyncFunction(function foo() {});  // Returns false
util.types.isAsyncFunction(async function foo() {});  // Returns true

function isAsyncFunction(object: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مثيل BigInt64Array.

util.types.isBigInt64Array(new BigInt64Array());   // Returns true
util.types.isBigInt64Array(new BigUint64Array());  // Returns false

function isBigInt64Array(value: unknown): value

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مثيل BigUint64Array.

util.types.isBigUint64Array(new BigInt64Array());   // Returns false
util.types.isBigUint64Array(new BigUint64Array());  // Returns true

function isBigUint64Array(value: unknown): value

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائنا منطقيا، على سبيل المثال تم إنشاؤه بواسطة new Boolean().

util.types.isBooleanObject(false);  // Returns false
util.types.isBooleanObject(true);   // Returns false
util.types.isBooleanObject(new Boolean(false)); // Returns true
util.types.isBooleanObject(new Boolean(true));  // Returns true
util.types.isBooleanObject(Boolean(false)); // Returns false
util.types.isBooleanObject(Boolean(true));  // Returns false

function isBooleanObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي أي عنصر بدائي مربع، على سبيل المثال تم إنشاؤه بواسطة new Boolean()أو new String() أو Object(Symbol()).

على سبيل المثال:

util.types.isBoxedPrimitive(false); // Returns false
util.types.isBoxedPrimitive(new Boolean(false)); // Returns true
util.types.isBoxedPrimitive(Symbol('foo')); // Returns false
util.types.isBoxedPrimitive(Object(Symbol('foo'))); // Returns true
util.types.isBoxedPrimitive(Object(BigInt(5))); // Returns true

function isBoxedPrimitive(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كان valueCryptoKey، false خلاف ذلك.

function isCryptoKey(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل DataView مضمن.

const ab = new ArrayBuffer(20);
util.types.isDataView(new DataView(ab));  // Returns true
util.types.isDataView(new Float64Array());  // Returns false

راجع أيضا ArrayBuffer.isView().

function isDataView(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Date مضمن.

util.types.isDate(new Date());  // Returns true

function isDate(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة قيمة External أصلية.

قيمة External الأصلية هي نوع خاص من العناصر التي تحتوي على مؤشر C++ الخام (void*) للوصول من التعليمات البرمجية الأصلية، وليس لها خصائص أخرى. يتم إنشاء هذه الكائنات إما عن طريق Node.js الداخلية أو الوظائف الإضافية الأصلية. في JavaScript، يتم تجميدها كائنات مع نموذج أوليnull.

#include <js_native_api.h>
#include <stdlib.h>
napi_value result;
static napi_value MyNapi(napi_env env, napi_callback_info info) {
  int* raw = (int*) malloc(1024);
  napi_status status = napi_create_external(env, (void*) raw, NULL, NULL, &#x26;result);
  if (status != napi_ok) {
    napi_throw_error(env, NULL, "napi_create_external failed");
    return NULL;
  }
  return result;
}
...
DECLARE_NAPI_PROPERTY("myNapi", MyNapi)
...

const native = require('napi_addon.node');
const data = native.myNapi();
util.types.isExternal(data); // returns true
util.types.isExternal(0); // returns false
util.types.isExternal(new String('foo')); // returns false

لمزيد من المعلومات حول napi_create_external، راجع napi_create_external().

function isExternal(object: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Float32Array مضمن.

util.types.isFloat32Array(new ArrayBuffer());  // Returns false
util.types.isFloat32Array(new Float32Array());  // Returns true
util.types.isFloat32Array(new Float64Array());  // Returns false

function isFloat32Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Float64Array مضمن.

util.types.isFloat64Array(new ArrayBuffer());  // Returns false
util.types.isFloat64Array(new Uint8Array());  // Returns false
util.types.isFloat64Array(new Float64Array());  // Returns true

function isFloat64Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة دالة منشئ. هذا فقط تقارير مرة أخرى ما يرى محرك JavaScript; على وجه الخصوص، قد لا تتطابق القيمة المرجعة مع التعليمات البرمجية المصدر الأصلية إذا تم استخدام أداة تبديل.

util.types.isGeneratorFunction(function foo() {});  // Returns false
util.types.isGeneratorFunction(function* foo() {});  // Returns true

function isGeneratorFunction(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائن مولد كما تم إرجاعه من دالة مولد مضمنة. هذا فقط تقارير مرة أخرى ما يرى محرك JavaScript; على وجه الخصوص، قد لا تتطابق القيمة المرجعة مع التعليمات البرمجية المصدر الأصلية إذا تم استخدام أداة تبديل.

function* foo() {}
const generator = foo();
util.types.isGeneratorObject(generator);  // Returns true

function isGeneratorObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Int16Array مضمن.

util.types.isInt16Array(new ArrayBuffer());  // Returns false
util.types.isInt16Array(new Int16Array());  // Returns true
util.types.isInt16Array(new Float64Array());  // Returns false

function isInt16Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Int32Array مضمن.

util.types.isInt32Array(new ArrayBuffer());  // Returns false
util.types.isInt32Array(new Int32Array());  // Returns true
util.types.isInt32Array(new Float64Array());  // Returns false

function isInt32Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Int8Array مضمن.

util.types.isInt8Array(new ArrayBuffer());  // Returns false
util.types.isInt8Array(new Int8Array());  // Returns true
util.types.isInt8Array(new Float64Array());  // Returns false

function isInt8Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كان valueKeyObject، false خلاف ذلك.

function isKeyObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Map مضمن.

util.types.isMap(new Map());  // Returns true

function isMap<T>(object: {} | T): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مكرر تم إرجاعه لمثيل Map مضمن.

const map = new Map();
util.types.isMapIterator(map.keys());  // Returns true
util.types.isMapIterator(map.values());  // Returns true
util.types.isMapIterator(map.entries());  // Returns true
util.types.isMapIterator(map[Symbol.iterator]());  // Returns true

function isMapIterator(object: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مثيلا لعنصر مساحة اسم الوحدة النمطية .

import * as ns from './a.js';

util.types.isModuleNamespaceObject(ns);  // Returns true

function isModuleNamespaceObject(value: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا تم إرجاع القيمة بواسطة الدالة الإنشائية لنوع Error مضمن .

console.log(util.types.isNativeError(new Error()));  // true
console.log(util.types.isNativeError(new TypeError()));  // true
console.log(util.types.isNativeError(new RangeError()));  // true

الفئات الفرعية من أنواع الأخطاء الأصلية هي أيضا أخطاء أصلية:

class MyError extends Error {}
console.log(util.types.isNativeError(new MyError()));  // true

القيمة التي يتم instanceof فئة خطأ أصلية لا تعادل isNativeError() إرجاع true لتلك القيمة. ترجع isNativeError()true للأخطاء التي تأتي من نطاق مختلف بينما يقوم instanceof Error بإرجاع false لهذه الأخطاء:

const vm = require('node:vm');
const context = vm.createContext({});
const myError = vm.runInContext('new Error()', context);
console.log(util.types.isNativeError(myError)); // true
console.log(myError instanceof Error); // false

وعلى العكس من ذلك، تقوم isNativeError() بإرجاع false لكافة الكائنات التي لم يتم إرجاعها بواسطة الدالة الإنشائية لخطأ أصلي. يتضمن ذلك القيم التي instanceof الأخطاء الأصلية:

const myError = { __proto__: Error.prototype };
console.log(util.types.isNativeError(myError)); // false
console.log(myError instanceof Error); // true

function isNativeError(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة عبارة عن عنصر رقم، على سبيل المثال تم إنشاؤه بواسطة new Number().

util.types.isNumberObject(0);  // Returns false
util.types.isNumberObject(new Number(0));   // Returns true

function isNumberObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة Promiseمضمنة .

util.types.isPromise(Promise.resolve(42));  // Returns true

function isPromise(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مثيل Proxy.

const target = {};
const proxy = new Proxy(target, {});
util.types.isProxy(target);  // Returns false
util.types.isProxy(proxy);  // Returns true

function isProxy(object: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائن تعبير عادي.

util.types.isRegExp(/abc/);  // Returns true
util.types.isRegExp(new RegExp('abc'));  // Returns true

function isRegExp(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Set مضمن.

util.types.isSet(new Set());  // Returns true

function isSet<T>(object: {} | T): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة مكرر تم إرجاعه لمثيل Set مضمن.

const set = new Set();
util.types.isSetIterator(set.keys());  // Returns true
util.types.isSetIterator(set.values());  // Returns true
util.types.isSetIterator(set.entries());  // Returns true
util.types.isSetIterator(set[Symbol.iterator]());  // Returns true

function isSetIterator(object: unknown): boolean

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل SharedArrayBuffer مضمن. لا يتضمن هذا مثيلات ArrayBuffer. عادة ما يكون من المستحسن اختبار كليهما؛ انظر util.types.isAnyArrayBuffer() لذلك.

util.types.isSharedArrayBuffer(new ArrayBuffer());  // Returns false
util.types.isSharedArrayBuffer(new SharedArrayBuffer());  // Returns true

function isSharedArrayBuffer(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائن سلسلة، على سبيل المثال تم إنشاؤه بواسطة new String().

util.types.isStringObject('foo');  // Returns false
util.types.isStringObject(new String('foo'));   // Returns true

function isStringObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة كائن رمز، تم إنشاؤه عن طريق استدعاء Object() على Symbol بدائية.

const symbol = Symbol('foo');
util.types.isSymbolObject(symbol);  // Returns false
util.types.isSymbolObject(Object(symbol));   // Returns true

function isSymbolObject(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل TypedArray مضمن.

util.types.isTypedArray(new ArrayBuffer());  // Returns false
util.types.isTypedArray(new Uint8Array());  // Returns true
util.types.isTypedArray(new Float64Array());  // Returns true

راجع أيضا ArrayBuffer.isView().

function isTypedArray(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Uint16Array مضمن.

util.types.isUint16Array(new ArrayBuffer());  // Returns false
util.types.isUint16Array(new Uint16Array());  // Returns true
util.types.isUint16Array(new Float64Array());  // Returns false

function isUint16Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Uint32Array مضمن.

util.types.isUint32Array(new ArrayBuffer());  // Returns false
util.types.isUint32Array(new Uint32Array());  // Returns true
util.types.isUint32Array(new Float64Array());  // Returns false

function isUint32Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Uint8Array مضمن.

util.types.isUint8Array(new ArrayBuffer());  // Returns false
util.types.isUint8Array(new Uint8Array());  // Returns true
util.types.isUint8Array(new Float64Array());  // Returns false

function isUint8Array(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل Uint8ClampedArray مضمن.

util.types.isUint8ClampedArray(new ArrayBuffer());  // Returns false
util.types.isUint8ClampedArray(new Uint8ClampedArray());  // Returns true
util.types.isUint8ClampedArray(new Float64Array());  // Returns false

function isUint8ClampedArray(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل WeakMap مضمن.

util.types.isWeakMap(new WeakMap());  // Returns true

function isWeakMap(object: unknown): object

المعلمات

المرتجعات

إرجاع true إذا كانت القيمة هي مثيل WeakSet مضمن.

util.types.isWeakSet(new WeakSet());  // Returns true

function isWeakSet(object: unknown): object

المعلمات

المرتجعات