StdLib2

变更梗概

• __GLOBAL
• AggregateError
• Error
• ArrayBuffer
• ArrayBufferTypes
• IArguments
• Intl
• Iterable
• Iterator
• IteratorResult
• IteratorReturnResult
• IteratorYieldResult
• IterableIterator

__GLOBAL

变更梗概

• __GLOBAL-ClassDecorator类型变更
• __GLOBAL-MethodDecorator类型变更
• __GLOBAL-ParameterDecorator类型变更
• __GLOBAL-PropertyDecorator类型变更
• __GLOBAL-PropertyKey类型变更
• __GLOBAL-FlatArray类型变更

变更详情

__GLOBAL-ClassDecorator类型变更

ArkTS1.1版本签名：
declare type ClassDecorator = <TFunction extends Function>(target: TFunction) => TFunction | void

参数：

参数名	类型	必填	说明
target	TFunction	是	被装饰的类构造函数。

返回值：

类型	说明
TFunction | void	返回修改后的构造函数或void。

示例：

let classDecorator: ClassDecorator = (target) => { return target };
@classDecorator
class A{}

ArkTS1.2版本签名：
不支持。

适配建议： 使用注解 (Annotation) 替代装饰器功能。

__GLOBAL-MethodDecorator类型变更

ArkTS1.1版本签名：
declare type MethodDecorator = <T>(target: Object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T> | void

参数：

参数名	类型	必填	说明
target	Object	是	目标对象。
propertyKey	string | symbol	是	方法名。
descriptor	TypedPropertyDescriptor<T>	是	属性描述符。

返回值：

类型	说明
TypedPropertyDescriptor<T> | void	返回修改后的描述符或void。

示例：

let methodDecorator: MethodDecorator = (target, propertyKey, descriptor) => {
  console.info(JSON.stringify(descriptor));
}
class A{
  @methodDecorator
  method(){}
}

ArkTS1.2版本签名：
不支持。

适配建议： 使用注解(Annotation)替代装饰器功能。

__GLOBAL-ParameterDecorator类型变更

ArkTS1.1版本签名：
declare type ParameterDecorator = (target: Object, propertyKey: string | symbol, parameterIndex: number) => void

参数：

参数名	类型	必填	说明
target	Object	是	目标对象。
propertyKey	string | symbol	是	方法名。
parameterIndex	number	是	参数索引。

示例：

let paramDecorator: ParameterDecorator = (target, methodName, paramIdx) => {
  console.info(methodName as string);
}
class A{
  method(@paramDecorator param: string){}
}

ArkTS1.2版本签名：
不支持。

适配建议： 使用注解(Annotation)替代装饰器功能。

__GLOBAL-PropertyDecorator类型变更

ArkTS1.1版本签名：
declare type PropertyDecorator = (target: Object, propertyKey: string | symbol) => void

参数：

参数名	类型	必填	说明
target	Object	是	目标对象。
propertyKey	string | symbol	是	属性名。

示例：

let propertyDecorator: PropertyDecorator = (target, propKey) => {
  console.info(propKey as string);
}
class A{
  @propertyDecorator
  prop = 1
}

ArkTS1.2版本签名：
不支持。

适配建议： 使用注解(Annotation)替代装饰器功能。

__GLOBAL-PropertyKey类型变更

ArkTS1.1版本签名：
declare type PropertyKey = string | number | symbol

示例：

let a: PropertyKey = 1;

ArkTS1.2版本签名：
type PropertyKey = string

示例：

let a: PropertyKey = "a";

适配建议： 仅使用字符串作为对象属性键。

__GLOBAL-FlatArray类型变更

ArkTS1.1版本签名：
type FlatArray<Arr, Depth extends number> = {"done": Arr,"recur": Arr extends ReadonlyArray<infer InnerArr> ? FlatArray<InnerArr, [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20][Depth]>: Arr}[Depth extends -1 ? "done" : "recur"]

示例：

const arr1 = [0, 1, 2, [3, 4]];
let arr: FlatArray<number[], -1> = arr1.flat();

ArkTS1.2版本签名：
不支持。

适配建议： 手动实现数组扁平化功能。

AggregateError

变更梗概

• AggregateError-构造函数参数类型变更
• AggregateError-errors属性类型变更
• AggregateError-Constructor变更

变更详情

AggregateError-构造函数参数类型变更

ArkTS1.1版本签名：
constructor(errors: Iterable<any>, message?: string, options?: ErrorOptions): AggregateError

参数：

参数名	类型	必填	说明
errors	Iterable<any>	是	可迭代的错误集合。
message	string	否	错误消息，默认值为"AggregateError"。
options	ErrorOptions	否	错误选项，默认值为undefined。

返回值：

类型	说明
AggregateError	新创建的AggregateError对象。

示例：

let err: AggregateError = new AggregateError([1, 2])

ArkTS1.2版本签名：
constructor(errors: Iterable<Error>, message?: string, options?: ErrorOptions): AggregateError

参数：

参数名	类型	必填	说明
errors	Iterable<Error>	是	可迭代的错误集合(仅限Error类型)。
message	string	否	错误消息，默认值为"AggregateError"。
options	ErrorOptions	否	错误选项，默认值为undefined。

返回值：

类型	说明
AggregateError	新创建的AggregateError对象。

示例：

let err: AggregateError = new AggregateError([Error("first error"), Error("second error")])

适配建议： 仅允许使用Error类型作为迭代器返回值的可迭代对象作为AggregateError构造器第一个参数，不建议使用其他类型对象作为参数传入。

AggregateError-errors属性类型变更

ArkTS1.1版本签名：
errors: any[]

返回值：

类型	说明
any[]	包含任意类型错误的数组。

示例：

let err: AggregateError = new AggregateError([1, 2])
let errors: Object[] = err.errors

ArkTS1.2版本签名：
errors: Error[]

返回值：

类型	说明
Error[]	仅包含Error类型错误的数组。

示例：

let err: AggregateError = new AggregateError([Error('first error'), Error('second error')])
let errors = err.errors

适配建议： 仅允许使用Error类型作为迭代器返回值的可迭代对象作为AggregateError构造器第一个参数，不建议使用其他类型对象作为参数传入。

AggregateError-Constructor变更

ArkTS1.1版本签名：
(errors: Iterable<any>, message?: string, options?: ErrorOptions): AggregateError

参数：

参数名	类型	必填	说明
errors	Iterable<any>	是	可迭代的任意类型对象。
message	string	否	错误消息，默认值为"AggregateError"。
options	ErrorOptions	否	错误选项，默认值为undefined。

返回值：

类型	说明
AggregateError	聚合错误对象。

示例：

function createAggregateError(ctor: AggregateErrorConstructor) {
  return ctor([Error("first error"), Error("second error")]);
}
function createAggregateErrorDirect() {
  return AggregateError([Error("first error"), Error("second error")]);
}

ArkTS1.2版本签名：
static AggregateError.invoke (errors: Iterable<Error>, message?: string, options?: ErrorOptions): AggregateError

参数：

参数名	类型	必填	说明
errors	Iterable<Error>	是	可迭代的错误对象。
message	string	否	错误消息，默认值为AggregateError。
options	ErrorOptions	否	错误选项，默认值为undefined。

返回值：

类型	说明
AggregateError	聚合错误对象。

示例：

function createAggregateError() {
  return AggregateError([Error("first error"), Error("second error")]);
}

适配建议： 直接创建对应类型的对象，不直接使用constructor类。

Error

• ArkTS1.2构造函数新增参数options。

Error构造函数入参变更

ArkTS1.1版本签名：
constructor(message?: string): Error

参数：

参数名	类型	必填	说明
message	string	否	错误的简要描述。默认值为无。

返回值：

类型	说明
Error	新的Error对象。

示例：

function createError(ctor: ErrorConstructor) {
  return ctor("some error");
}
function createErrorDirect() {
  return Error("some error");
}

ArkTS1.2版本签名：
constructor(message?: String, options?: ErrorOptions): Error

参数：

参数名	类型	必填	说明
message	String	否	错误的简要描述。默认值为无。
options	ErrorOptions	否	Error的属性，指示导致该错误的具体原始原因。其中ErrorOptions为ArkTS1.2版本新增类，只包含一个可选属性cause，表示导致该错误的具体原始原因。默认值为无。

适配建议： ArkTS1.2相比ArkTS1.1接口签名有变更，但对开发者接口行为无变更。

示例：

function createError() {
  return Error("some error");
}

ArrayBuffer

• any类型变更为Object，返回值类型为布尔类型。

ArrayBuffer-isView方法签名变更

ArkTS1.1版本签名：
static isView(arg: any): arg is ArrayBufferView

参数：

参数名	类型	必填	说明
arg	any	是	要判断是否是ArrayBufferView类型的值，可以是任意类型。

返回值：

类型	说明
arg is ArrayBufferView	类型守卫，通知编译器在某个条件为true时，arg是一个ArrayBufferView类型。

示例：

const buffer = new ArrayBuffer(16);
const int32View = new Int32Array(buffer);

console.info("boolean: "+ ArrayBuffer.isView(int32View)); // true
console.info("boolean: "+ ArrayBuffer.isView(null));      // false
console.info("boolean: "+ ArrayBuffer.isView(undefined)); // false

ArkTS1.2版本签名：
static isView(obj: Object): boolean

参数：

参数名	类型	必填	说明
obj	Object	是	要判断是否是ArrayBufferView类型的值，对象类型，不包含null和undefined。

返回值：

类型	说明
boolean	表示arg是否是一个ArrayBufferView类型。true表示是，false表示不是。

示例：

const buffer = new ArrayBuffer(16);
const int32View = new Int32Array(buffer);

console.info("boolean: "+ ArrayBuffer.isView(int32View)); // true
console.error("boolean: "+ ArrayBuffer.isView(null));      // TypeError: Type 'null' is not compatible with type 'Object' at index
console.error("boolean: "+ ArrayBuffer.isView(undefined)); // TypeError: Type 'undefined' is not compatible with type 'Object' at index

适配建议： ArkTS1.2相比ArkTS1.1接口签名入参范围缩小，null和undefined不能入参，返回值无行为变更。

ArrayBufferTypes

变更梗概

• ArrayBufferTypes类型移除
• SharedArrayBuffer类型移除

变更详情

ArrayBufferTypes类型移除

ArkTS1.1版本签名：
ArrayBuffer: ArrayBuffer

返回值：

类型	说明
ArrayBuffer	ArrayBuffer对象。

示例：

let c:ArrayBufferTypes = {
  ArrayBuffer: new ArrayBuffer(10),
  SharedArrayBuffer: new SharedArrayBuffer(10)
};
c.ArrayBuffer;
c.SharedArrayBuffer;

ArkTS1.2版本签名：
不支持

适配建议： 不使用ArrayBufferTypes，如果需要使用类似结构可以自定义类型。

SharedArrayBuffer类型移除

ArkTS1.1版本签名：
SharedArrayBuffer: SharedArrayBuffer

返回值：

类型	说明
SharedArrayBuffer	SharedArrayBuffer对象。

ArkTS1.2版本签名：
不支持。

适配建议： 不使用ArrayBufferTypes，如果需要使用类似结构可以自定义类型。

IArguments

变更梗概

• IArguments类型移除
• IArguments-callee属性移除
• IArguments-length属性移除

变更详情

IArguments类型移除

ArkTS1.1版本签名：
[Symbol.iterator](): IterableIterator<any>

返回值：

类型	说明
IterableIterator<any>	arguments的迭代器。

示例：

function f(a:number,b:string){
  Reflect.get(arguments, Symbol.iterator);
}

ArkTS1.2版本签名：
不支持。

适配建议： ArkTS1.2不能使用arguments，因此不需要使用IArguments。

IArguments-callee属性移除

ArkTS1.1版本签名：
callee: Function

返回值：

类型	说明
Function	当前执行的函数。

示例：

function f(a:number,b:string){
  arguments.callee;
}

ArkTS1.2版本签名：
不支持。

适配建议： ArkTS1.2不能使用arguments，因此不需要使用callee。

IArguments-length属性移除

ArkTS1.1版本签名：
length: number

返回值：

类型	说明
number	参数个数。

示例：

function f(a:number,b:string){
  console.info(arguments.length.toString());
}

ArkTS1.2版本签名：
不支持。

适配建议： ArkTS1.2不能使用arguments，因此不需要使用length属性。

Intl

变更梗概

• DateTimeFormat变更
• DateTimeFormatPartTypesRegistry变更
• DisplayNames变更
• ListFormat访问变更
• NumberFormat变更

变更详情

DateTimeFormat变更

• ArkTS1.1 版本签名：
  readonly prototype: DateTimeFormat

示例：

Reflect.get(Intl.DateTimeFormat, "prototype")

ArkTS1.2版本签名：
不支持。

适配建议： 静态语言不支持去修改prototype，建议创建新的对象。

DateTimeFormatPartTypesRegistry变更

ArkTS1.1版本签名：
interface DateTimeFormatPartTypesRegistry { day: any dayPeriod: any era: any hour: any literal: any minute: any month: any second: any timeZoneName: any weekday: any year: any }

示例：

let o: Intl.DateTimeFormatPartTypesRegistry = {
  day: undefined,
  dayPeriod: undefined,
  era: undefined,
  hour: undefined,
  literal: undefined,
  minute: undefined,
  month: undefined,
  second: undefined,
  timeZoneName: undefined,
  weekday: undefined,
  year: undefined,
  unknown: undefined,
  fractionalSecond: undefined
}

ArkTS1.2版本签名：
不支持。

适配建议： 不使用Intl.DateTimeFormatPartTypesRegistry。

DisplayNames变更

ArkTS1.1版本签名：
prototype: DisplayNames

示例：

Reflect.get(Intl.DisplayNames, "prototype")

ArkTS1.2版本签名：
不支持。

适配建议： 静态语言不支持去修改prototype，建议创建新的对象。

ListFormat访问变更

ArkTS1.1版本签名：
prototype: ListFormat

示例：

Reflect.get(Intl.ListFormat, "prototype")

ArkTS1.2版本签名：
不支持。

适配建议： 静态语言不支持去修改prototype，建议创建新的对象。

NumberFormat变更

ArkTS1.1版本签名：
readonly prototype: NumberFormat

示例：

Reflect.get(Intl.NumberFormat, "prototype")

ArkTS1.2版本签名：
不支持。

适配建议： 静态语言不支持去修改prototype，建议创建新的对象。

Iterable

变更梗概

• Iterable-Symbol.iterator变更

变更详情

Iterable-Symbol.iterator变更

ArkTS1.1版本签名：
[Symbol.iterator](): Iterator<T>

返回值：

类型	说明
Iterator<T>	迭代器对象。

示例：

function f<T>(a: Iterable<T>) {
  Reflect.get(a, Symbol.iterator);
}

ArkTS1.2版本签名：
$_iterator(): Iterator<T>

返回值：

类型	说明
Iterator<T>	迭代器对象。

示例：

class C<T> implements Iterable<T> {
  $_iterator(): Iterator<T> {
    //....
  }
}

适配建议： 建议仅使用for...of访问迭代器，不要显示访问迭代器。

Iterator

变更梗概

• Iterator-return方法变更
• Iterator-throw方法变更

变更详情

Iterator-return方法变更

ArkTS1.1版本签名：
return?(value?: TReturn): IteratorResult<T, TReturn>

参数：

参数名	类型	必填	说明
value	TReturn	否	可选的返回值，默认值为undefined。

返回值：

类型	说明
IteratorResult<T, TReturn>	迭代结果对象。

示例：

class C implements Iterator<number|undefined> {
  a: number = 0;
  b: number;
  constructor (b: number) {
    this.b = b;
  }
  next(): IteratorResult<number> {
    if (this.a >= this.b) {
      return {value: undefined, done: true};
    }
    this.a++;
    return {value: this.a, done: false};
  }
  return(): IteratorResult<number> {
    console.info("call return");
    this.a = 0;
    return {value: undefined, done: true};
  }
}
let a = new C(5);
a.next();
a.return();

ArkTS1.2版本签名：
ArkTs1.2 Iterator中没有return()接口

适配建议： 不使用return方法。

Iterator-throw方法变更

ArkTS1.1版本签名：
throw?(e?: any): IteratorResult<T, TReturn>

参数：

参数名	类型	必填	说明
e	any	否	可选的错误对象，默认值为undefined。

返回值：

类型	说明
IteratorResult<T, TReturn>	迭代结果对象。

示例：

class C implements Iterator<number|undefined> {
  private done = false;

  next(): IteratorResult<number|undefined> {
    if (this.done) {
      return { value: undefined, done: false };
    }
    this.done = true;
    return { value: 1, done: false };
  }

  throw(e: Error): IteratorResult<number> {
    console.error("Error: " + e);
    return { value: undefined, done: true };
  }

  return(value?: number): IteratorResult<number> {
    return { value: value ?? undefined, done: true };
  }
}
let a = new C();
a.throw(new Error("test"));

ArkTS1.2版本签名：
ArkTs1.2 Iterator中没有throw()接口

适配建议： 不使用throw方法。

IteratorResult

变更详情

IteratorResult定义变更

ArkTS1.1版本签名：
type IteratorResult<T, TReturn = any> = IteratorYieldResult<T> | IteratorReturnResult<TReturn>

类型：

类型	说明
IteratorResult<T, TReturn = any>	表示迭代器返回结果的类型。
IteratorYieldResult<T>	表示迭代器产生了一个值（yield）。
IteratorReturnResult<TReturn>	表示迭代器已经完成（return）。

示例：

let arr = new Array(1,2,3); 
let iterator = arr.entries(); 
let res = iterator.next(); 
console.info(res.value[0])

ArkTS1.2版本签名：

export class IteratorResult<T> {
  done: boolean 
  value: T | undefined

  constructor() {
      this.done = true
      this.value = undefined
  }

  constructor(done: boolean, value: T | undefined) {
      this.done = done
      this.value = value
  }

  constructor(value: T) {
      this.done = false
      this.value = value
  }
}

参数：

参数名	类型	必填	说明
done	boolean	是	表示是否迭代结束。true表示迭代结束，false表示迭代仍在进行中。
value	T | undefined	是	表示迭代器中间产生的值。

示例：

let arr = new Array<number>(1,2,3); 
let iterator = arr.entries(); 
let res = iterator.next(); 
console.info(res!.value![0]);

适配建议： 正常使用，但当从迭代器里面获取value值的时候要注意判断是否为undefined。

IteratorReturnResult

变更详情

IteratorReturnResult定义变更

ArkTS1.1版本签名：

interface IteratorReturnResult<TReturn> {
  done: true;
  value: TReturn;
}

参数：

参数名	类型	必填	说明
done	true	是	表示迭代结束。
value	TReturn	是	表示迭代器最终返回的值，TReturn表示最终返回值的类型。

示例：

let b:IteratorYieldResult<string>;

ArkTS1.2版本签名：
NA

适配建议： 使用IteratorResult。

IteratorYieldResult

变更详情

IteratorYieldResult定义变更

ArkTS1.1版本签名：

interface IteratorYieldResult<TYield> {
  done?: false;
  value: TYield;
}

参数：

参数名	类型	必填	说明
done	false	否	表示迭代仍在进行中。默认值为无。
value	TYield	是	表示迭代器中间产生的值，TYield表示产生值的类型。

示例：

let b:IteratorReturnResult<string>;

ArkTS1.2版本签名：
NA

适配建议： 没有generate function，不使用IteratorYieldResult。

IterableIterator

变更梗概

• IterableIterator-Symbol.iterator变更

变更详情

IterableIterator-Symbol.iterator变更

ArkTS1.1 版本签名：
[Symbol.iterator](): IterableIterator<T>

返回值：

类型	说明
IterableIterator<T>	表示返回一个可迭代的迭代器对象。

示例：

function f<T>(a: IterableIterator<T>) {
  Reflect.get(a, Symbol.iterator);
}

ArkTS1.2版本签名：
$_iterator(): IterableIterator<T>

返回值：

类型	说明
IterableIterator<T>	表示返回一个可迭代的迭代器对象。

示例：

class C<T> implements IterableIterator<T> {
  $_iterator(): IterableIterator<T> {
    return new C<T>();
  }
  next(): IteratorResult<T> {
    return new IteratorResult<T>();
  }
}

适配建议： 建议仅使用for...of访问迭代器，不要显示访问迭代器。