util工具函數

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標單獨標記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

該模塊主要提供常用的工具函數，實現字符串編解碼（TextEncoder，TextDecoder）、有理數運算（RationalNumber）、緩沖區(qū)管理（LruBuffer）、范圍判斷（Scope）、Base64編解碼（Base64）、內置對象類型檢查（Types）等功能。

導入模塊

import util from '@ohos.util';

util.printf

printf(format: string, ...args: Object[]): string

通過式樣化字符串對輸入的內容按特定格式輸出。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var res = util.printf("%s", "hello world!");
console.log(res);

util.getErrorString

getErrorString(errno: number): string

獲取系統錯誤碼對應的詳細信息。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var errnum = 10; // 10：a system error number
var result = util.getErrorString(errnum);
console.log("result = " + result);

util.callbackWrapper

callbackWrapper(original: Function): (err: Object, value: Object )=>void

對異步函數進行回調化處理，回調中第一個參數將是拒絕原因（如果 Promise 已解決，則為 null），第二個參數將是已解決的值。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

async function promiseFn() {
    return Promise.reject('value');
}
var cb = util.callbackWrapper(promiseFn);
cb((err, ret) = > {
    console.log(err);
    console.log(ret);
})

util.promiseWrapper

promiseWrapper(original: (err: Object, value: Object) => void): Object

對異步函數處理并返回一個promise的版本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

function aysnFun(str1, str2, callback) {
    if (typeof str1 === 'string' && typeof str2 === 'string') {
        callback(null, str1 + str2);
    } else {
        callback('type err');
    }
}
let newPromiseObj = util.promiseWrapper(aysnFun)("Hello", 'World');
newPromiseObj.then(res = > {
    console.log(res);
})

TextDecoder

屬性

系統能力： 以下各項對應的系統能力均為SystemCapability.Utils.Lang。

constructor

constructor(encoding?: string, options?: { fatal?: boolean; ignoreBOM?: boolean },)

TextDecoder的構造函數。

系統能力： SystemCapability.Utils.Lang

參數：

表1 options

示例：

var textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});

decode

decode(input: Uint8Array, options?: { stream?: false }): string

通過輸入參數解碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

表2 options

返回值：

示例：

var textDecoder = new util.TextDecoder("utf-8",{ignoreBOM: true});
var result = new Uint8Array(6);
result[0] = 0xEF;
result[1] = 0xBB;
result[2] = 0xBF;
result[3] = 0x61;
result[4] = 0x62;
result[5] = 0x63;
console.log("input num:");
var retStr = textDecoder.decode( result , {stream: false});
console.log("retStr = " + retStr);

TextEncoder

屬性

系統能力： 以下各項對應的系統能力均為SystemCapability.Utils.Lang。

constructor

constructor()

TextEncoder的構造函數。

系統能力： SystemCapability.Utils.Lang

示例：

var textEncoder = new util.TextEncoder();

encode

encode(input?: string): Uint8Array

通過輸入參數編碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var textEncoder = new util.TextEncoder();
var buffer = new ArrayBuffer(20);
var result = new Uint8Array(buffer);
result = textEncoder.encode("uD800￥￥");

encodeInto

encodeInto(input: string, dest: Uint8Array, ): { read: number; written: number }

放置生成的UTF-8編碼文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.TextEncoder();
var buffer = new ArrayBuffer(4);
this.dest = new Uint8Array(buffer);
var result = that.encodeInto("abcd", this.dest);

RationalNumber8+

constructor8+

constructor(numerator: number,denominator: number)

RationalNumber的構造函數。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var rationalNumber = new util.RationalNumber(1,2);

createRationalFromString8+

static createRationalFromString?(rationalString: string): RationalNumber?

基于給定的字符串創(chuàng)建一個RationalNumber對象。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var rational = rationalNumer.creatRationalFromString("3/4");

compareTo8+

compareTo?(another: RationalNumber): number?

將當前的RationalNumber對象與給定的對象進行比較。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var rational = rationalNumer.creatRationalFromString("3/4");
var result = rationalNumber.compareTo(rational);

valueOf8+

valueOf(): number

以整數形式或者浮點數的形式獲取當前RationalNumber對象的值。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.valueOf();

equals8+

equals?(obj: Object): boolean

將當前的RationalNumber對象與給定的對象進行比較是否相等。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var rational = rationalNumer.creatRationalFromString("3/4");
var result = rationalNumber.equals(rational);

getCommonDivisor8+

static getCommonDivisor?(number1: number,number2: number): number

獲取兩個指定整數的最大公約數。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.getCommonDivisor(4,6);

getNumerator8+

getNumerator?(): number

獲取當前RationalNumber對象的分子。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.getNumerator();

getDenominator8+

getDenominator?(): number

獲取當前RationalNumber對象的分母。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.getDenominator();

isZero8+

isZero?():boolean

檢查當前RationalNumber對象是否為0。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.isZero();

isNaN8+

isNaN?(): boolean

檢查當前RationalNumber對象是否表示非數字(NaN)值。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.isNaN();

isFinite8+

isFinite?():boolean

檢查當前RationalNumber對象是否表示一個有限值。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.isFinite();

toString8+

toString?(): string

獲取當前RationalNumber對象的字符串表示形式。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var rationalNumber = new util.RationalNumber(1,2);
var result = rationalNumber.toString();

LruBuffer8+

屬性

系統能力： 以下各項對應的系統能力均為SystemCapability.Utils.Lang。

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.put(1,8);
var result = pro.length;

constructor8+

constructor(capacity?: number)

默認構造函數用于創(chuàng)建一個新的LruBuffer實例，默認容量為64。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var lrubuffer= new util.LruBuffer();

updateCapacity8+

updateCapacity(newCapacity: number): void

將緩沖區(qū)容量更新為指定容量，如果newCapacity小于或等于0，則拋出異常。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var pro = new util.LruBuffer();
var result = pro.updateCapacity(100);

toString8+

toString(): string

返回對象的字符串表示形式。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
pro.remove(20);
var result = pro.toString();

getCapacity8+

getCapacity(): number

獲取當前緩沖區(qū)的容量。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
var result = pro.getCapacity();

clear8+

clear(): void

從當前緩沖區(qū)清除鍵值對。后續(xù)會調用afterRemoval()方法執(zhí)行后續(xù)操作。

系統能力： SystemCapability.Utils.Lang

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.size();
pro.clear();

getCreateCount8+

getCreateCount(): number

獲取createDefault()返回值的次數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(1,8);
var result = pro.getCreateCount();

getMissCount8+

getMissCount(): number

獲取查詢值不匹配的次數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
var result = pro.getMissCount();

getRemovalCount8+

getRemovalCount(): number

獲取從緩沖區(qū)中逐出值的次數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.updateCapacity(2);
pro.put(50,22);
var result = pro.getRemovalCount();

getMatchCount8+

getMatchCount(): number

獲取查詢值匹配成功的次數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.get(2);
var result = pro.getMatchCount();

getPutCount8+

getPutCount(): number

獲取將值添加到緩沖區(qū)的次數。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.getPutCount();

isEmpty8+

isEmpty(): boolean

檢查當前緩沖區(qū)是否為空。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.isEmpty();

get8+

get(key: K): V | undefined

表示要查詢的鍵。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result  = pro.get(2);

put8+

put(key: K,value: V): V

將鍵值對添加到緩沖區(qū)。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pro = new util.LruBuffer();
var result = pro.put(2,10);

values8+

values(): V[]

獲取當前緩沖區(qū)中所有值從最近訪問到最近最少訪問的順序列表 。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
pro.put(2,"anhu");
pro.put("afaf","grfb");
var result = pro.values();

keys8+

keys(): K[]

獲取當前緩沖區(qū)中所有鍵從最近訪問到最近最少訪問的升序列表。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.keys();

remove8+

remove(key: K): V | undefined

從當前緩沖區(qū)中刪除指定的鍵及其關聯的值。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.remove(20);

afterRemoval8+

afterRemoval(isEvict: boolean,key: K,value: V,newValue: V): void

刪除值后執(zhí)行后續(xù)操作。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var arr = [];
class ChildLruBuffer extends util.LruBuffer
{
	constructor()
	{
		super();
	}
	static getInstance()
	{
		if(this.instance ==  null)
		{
			this.instance = new ChildLruBuffer();
		}
		return this.instance;  
	}
	afterRemoval(isEvict, key, value, newValue)
	{
		if (isEvict === false)
		{
			arr = [key, value, newValue];
		}
	}
}
ChildLruBuffer.getInstance().afterRemoval(false,10,30,null);

contains8+

contains(key: K): boolean

檢查當前緩沖區(qū)是否包含指定的鍵。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.contains(20);

createDefault8+

createDefault(key: K): V

如果未計算特定鍵的值，則執(zhí)行后續(xù)操作，參數表示丟失的鍵，返回與鍵關聯的值。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var pro = new util.LruBuffer();
var result = pro.createDefault(50);

entries8+

entries(): IterableIterator<[K,V]>

允許迭代包含在這個對象中的所有鍵值對。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro.entries();

[Symbol.iterator]8+

Symbol.iterator: IterableIterator<[K, V]>

返回一個鍵值對形式的二維數組。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var pro = new util.LruBuffer();
pro.put(2,10);
var result = pro[symbol.iterator]();

Scope8+

ScopeType8+

用于表示范圍中的值的類型。該類型的值，類型可以為ScopeComparable或number。

ScopeComparable類型的值需要實現compareTo方法，確保傳入的數據具有可比性。

interface ScopeComparable{
    compareTo(other: ScopeComparable): boolean;
}
type ScopeType = ScopeComparable | number;

構造新類，實現compareTo方法。后續(xù)示例代碼中，均通過Temperature，獲取[ScopeType]的實例化對象。

示例：

class Temperature{
    constructor(value){
       // 當使用ts語言開發(fā)時，需要補充以下代碼：
       // private readonly _temp: Temperature;
       this._temp = value;
    }
    comapreTo(value){
       return this._temp >= value.getTemp();
    }
    getTemp(){
       return this._temp;
    }
    toString(){
       return this._temp.toString();
    }
}

constructor8+

constructor(lowerObj: ScopeType, upperObj: ScopeType)

用于創(chuàng)建指定下限和上限的作用域實例的構造函數，返回一個Scope對象。

系統能力： SystemCapability.Utils.Lang

參數：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);

toString8+

toString(): string

該字符串化方法返回一個包含當前范圍的字符串表示形式。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);
var result = range.toString();

intersect8+

intersect(range: Scope): Scope

獲取給定范圍和當前范圍的交集。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);
var tempMiDF = new Temperature(35);
var tempMidS = new Temperature(39);
var rangeFir = new util.Scope(tempMiDF, tempMidS);
range.intersect(rangeFir );

intersect8+

intersect(lowerObj:ScopeType,upperObj:ScopeType):Scope

獲取當前范圍與給定下限和上限范圍的交集。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var tempMidS = new Temperature(39);
var range = new util.Scope(tempLower, tempUpper);
var result = range.intersect(tempMiDF, tempMidS);

getUpper8+

getUpper(): ScopeType

獲取當前范圍的上限。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);
var result = range.getUpper();

getLower8+

getLower(): ScopeType

獲取當前范圍的下限。

系統能力： SystemCapability.Utils.Lang

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);
var result = range.getLower();

expand8+

expand(lowerObj: ScopeType,upperObj: ScopeType): Scope

創(chuàng)建并返回包括當前范圍和給定下限和上限的并集。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var tempMidS = new Temperature(39);
var range = new util.Scope(tempLower, tempUpper);
var result = range.expand(tempMiDF, tempMidS);

expand8+

expand(range: Scope): Scope

創(chuàng)建并返回包括當前范圍和給定范圍的并集。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var tempMidS = new Temperature(39);
var range = new util.Scope(tempLower, tempUpper);
var rangeFir = new util.Scope(tempMiDF, tempMidS);
var result = range.expand(rangeFir);

expand8+

expand(value: ScopeType): Scope

創(chuàng)建并返回包括當前范圍和給定值的并集。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var range = new util.Scope(tempLower, tempUpper);
var result = range.expand(tempMiDF);

contains8+

contains(value: ScopeType): boolean

檢查給定value是否包含在當前范圍內。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var range = new util.Scope(tempLower, tempUpper);
range.contains(tempMiDF);

contains8+

contains(range: Scope): boolean

檢查給定range是否在當前范圍內。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var range = new util.Scope(tempLower, tempUpper);
var tempLess = new Temperature(20);
var tempMore = new Temperature(45);
var rangeSec = new util.Scope(tempLess, tempMore);
var result = range.contains(rangeSec);

clamp8+

clamp(value: ScopeType): ScopeType

將給定值限定到當前范圍內。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var tempLower = new Temperature(30);
var tempUpper = new Temperature(40);
var tempMiDF = new Temperature(35);
var range = new util.Scope(tempLower, tempUpper);
var result = range.clamp(tempMiDF);

Base648+

constructor8+

constructor()

Base64的構造函數。

系統能力： SystemCapability.Utils.Lang

示例：

var base64 = new  util.Base64();

encodeSync8+

encodeSync(src: Uint8Array): Uint8Array

通過輸入參數編碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var array = new Uint8Array([115,49,51]);
var result = that.encodeSync(array);

encodeToStringSync8+

encodeToStringSync(src: Uint8Array): string

通過輸入參數編碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var array = new Uint8Array([115,49,51]);
var result = that.encodeToStringSync(array);

decodeSync8+

decodeSync(src: Uint8Array | string): Uint8Array

通過輸入參數解碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var buff = 'czEz';
var result = that.decodeSync(buff);

encode8+

encode(src: Uint8Array): Promise

通過輸入參數異步編碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var array = new Uint8Array([115,49,51]);
var rarray = new Uint8Array([99,122,69,122]);
that.encode(array).then(val= >{    
    for (var i = 0; i < rarray.length; i++) {        
        console.log(val[i])
    }
})

encodeToString8+

encodeToString(src: Uint8Array): Promise

通過輸入參數異步編碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var array = new Uint8Array([115,49,51]);
that.encodeToString(array).then(val= >{    
    console.log(val)
})

decode8+

decode(src: Uint8Array | string): Promise

通過輸入參數異步解碼后輸出對應文本。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.Base64();
var array = new Uint8Array([99,122,69,122]);
var rarray = new Uint8Array([115,49,51]);
that.decode(array).then(val= >{    
    for (var i = 0; i < rarray.length; i++) {        
        console.log(val[i])
    }
})

types8+

constructor8+

constructor()

Types的構造函數。

系統能力： SystemCapability.Utils.Lang

示例：

var type = new util.types();

isAnyArrayBuffer8+

isAnyArrayBuffer(value: Object): boolean

檢查輸入的value是否是ArrayBuffer類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isAnyArrayBuffer(new ArrayBuffer([]));

isArrayBufferView8+

isArrayBufferView(value: Object): boolean

檢查輸入的value是否是內置ArrayBufferView輔助類型。

ArrayBufferView輔助類型包括：Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint32Array、Float32Array、Float64Array、DataView。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isArrayBufferView(new Int8Array([]));

isArgumentsObject8+

isArgumentsObject(value: Object): boolean

檢查輸入的value是否是一個arguments對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
function foo() {
    var result = that.isArgumentsObject(arguments);
}
var f = foo();

isArrayBuffer8+

isArrayBuffer(value: Object): boolean

檢查輸入的value是否是ArrayBuffer類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isArrayBuffer(new ArrayBuffer([]));

isAsyncFunction8+

isAsyncFunction(value: Object): boolean

檢查輸入的value是否是一個異步函數類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isAsyncFunction(async function foo() {});

isBooleanObject8+

isBooleanObject(value: Object): boolean

檢查輸入的value是否是一個Boolean對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isBooleanObject(new Boolean(true));

isBoxedPrimitive8+

isBoxedPrimitive(value: Object): boolean

檢查輸入的value是否是Boolean或Number或String或Symbol對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isBoxedPrimitive(new Boolean(false));

isDataView8+

isDataView(value: Object): boolean

檢查輸入的value是否是DataView類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const ab = new ArrayBuffer(20);
var result = that.isDataView(new DataView(ab));

isDate8+

isDate(value: Object): boolean

檢查輸入的value是否是Date類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isDate(new Date());

isExternal8+

isExternal(value: Object): boolean

檢查輸入的value是否是native External類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const data = util.createExternalType();
var result = that.isExternal(data);

isFloat32Array8+

isFloat32Array(value: Object): boolean

檢查輸入的value是否是Float32Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isFloat32Array(new Float32Array());

isFloat64Array8+

isFloat64Array(value: Object): boolean

檢查輸入的value是否是Float64Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isFloat64Array(new Float64Array());

isGeneratorFunction8+

isGeneratorFunction(value: Object): boolean

檢查輸入的value是否是generator函數類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isGeneratorFunction(function* foo() {});

isGeneratorObject8+

isGeneratorObject(value: Object): boolean

檢查輸入的value是否是generator對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
function* foo() {}
const generator = foo();
var result = that.isGeneratorObject(generator);

isInt8Array8+

isInt8Array(value: Object): boolean

檢查輸入的value是否是Int8Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isInt8Array(new Int8Array([]));

isInt16Array8+

isInt16Array(value: Object): boolean

檢查輸入的value是否是Int16Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isInt16Array(new Int16Array([]));

isInt32Array8+

isInt32Array(value: Object): boolean

檢查輸入的value是否是Int32Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isInt32Array(new Int32Array([]));

isMap8+

isMap(value: Object): boolean

檢查輸入的value是否是Map類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isMap(new Map());

isMapIterator8+

isMapIterator(value: Object): boolean

檢查輸入的value是否是Map的Iterator類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const map = new Map();
var result = that.isMapIterator(map.keys());

isNativeError8+

isNativeError(value: Object): boolean

檢查輸入的value是否是Error類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isNativeError(new TypeError());

isNumberObject8+

isNumberObject(value: Object): boolean

檢查輸入的value是否是Number對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isNumberObject(new Number(0));

isPromise8+

isPromise(value: Object): boolean

檢查輸入的value是否是Promise類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isPromise(Promise.resolve(1));

isProxy8+

isProxy(value: Object): boolean

檢查輸入的value是否是Proxy類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const target = {};
const proxy = new Proxy(target, {});
var result = that.isProxy(proxy);

isRegExp8+

isRegExp(value: Object): boolean

檢查輸入的value是否是RegExp類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isRegExp(new RegExp('abc'));

isSet8+

isSet(value: Object): boolean

檢查輸入的value是否是Set類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isSet(new Set());

isSetIterator8+

isSetIterator(value: Object): boolean

檢查輸入的value是否是Set的Iterator類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const set = new Set();
var result = that.isSetIterator(set.keys());

isStringObject8+

isStringObject(value: Object): boolean

檢查輸入的value是否是String對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isStringObject(new String('foo'));

[](https://gitee.com/openharmony/docs/blob/OpenHarmony-3.2-Beta1/zh-cn/application-dev/reference/apis/js-apis-util.md#issymbolobjec8)isSymbolObjec8+

isSymbolObject(value: Object): boolean

檢查輸入的value是否是Symbol對象類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
const symbols = Symbol('foo');
var result = that.isSymbolObject(Object(symbols));

isTypedArray8+

isTypedArray(value: Object): boolean

檢查輸入的value是否是TypedArray類型的輔助類型。

TypedArray類型的輔助類型，包括Int8Array、Int16Array、Int32Array、Uint8Array、Uint8ClampedArray、Uint16Array、Uint32Array、Float32Array、Float64Array、DataView。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isTypedArray(new Float64Array([]));

isUint8Array8+

isUint8Array(value: Object): boolean

檢查輸入的value是否是Uint8Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isUint8Array(new Uint8Array([]));

isUint8ClampedArray8+

isUint8ClampedArray(value: Object): boolean

檢查輸入的value是否是Uint8ClampedArray數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isUint8ClampedArray(new Uint8ClampedArray([]));

isUint16Array8+

isUint16Array(value: Object): boolean

檢查輸入的value是否是Uint16Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isUint16Array(new Uint16Array([]));

isUint32Array8+

isUint32Array(value: Object): boolean

檢查輸入的value是否是Uint32Array數組類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isUint32Array(new Uint32Array([]));

isWeakMap8+

isWeakMap(value: Object): boolean

檢查輸入的value是否是WeakMap類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isWeakMap(new WeakMap());

isWeakSet8+

isWeakSet(value: Object): boolean

檢查輸入的value是否是WeakSet類型。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

示例：

var that = new util.types();
var result = that.isWeakSet(new WeakSet());

審核編輯 黃宇