1# 语言基础类库错误码
2
3> **说明:**
4>
5> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。
6
7## 10200001 参数范围越界错误
8
9**错误信息**
10
11The value of ${param} is out of range.
12
13**错误描述**
14
15调用接口时某个参数超出了其正常范围的取值。
16
17**可能原因**
18
19某个参数索引超出可用范围。
20
21**处理步骤**
22
23检查输入参数的索引是否越界。
24
25## 10200002 参数解析错误
26
27**错误信息**
28
29Invalid ${param} string.
30
31**错误描述**
32
33规范字符串解析失败。
34
35**可能原因**
36
37调用接口时,某个字符串类型的参数为非规范的字符串,导致解析该字符串失败。
38
39**处理步骤**
40
41检查输入字符串的格式。
42
43## 10200003 Worker初始化失败
44
45**错误信息**
46
47Worker initialization failed.
48
49**错误描述**
50
51调用接口时Worker未能正常初始化。
52
53**可能原因**
54
551. 创建Worker的数量超出限制。
562. 设置Worker对象的选择项不正确。
57
58**处理步骤**
59
601. 检查Worker的数量是否超出8个,如果存在,及时销毁空闲的Worker。
612. 如果设置WorkerOptions,检查参数类型及其合法性。
62
63## 10200004 Worker处于非运行状态
64
65**错误信息**
66
67The Worker instance is not running.
68
69**错误描述**
70
71调用接口时Worker对象处于非运行状态。
72
73**可能原因**
74
75当调用接口时,Worker实例化对象已经被销毁,或正在被销毁。
76
77**处理步骤**
78
79当调用接口时,确保Worker对象处于正常运行状态,未被执行销毁操作。
80
81## 10200005 Worker不支持某API
82
83**错误信息**
84
85The called API is not supported in the worker thread.
86
87**错误描述**
88
89Worker不支持某API。
90
91**可能原因**
92
93调用Worker线程中不支持的API。
94
95**处理步骤**
96
97确保使用Worker线程中支持的API。
98
99## 10200006 Worker传输信息序列化异常
100
101**错误信息**
102
103An exception occurred during serialization.
104
105**错误描述**
106
107Worker传输信息序列化异常。
108
109**可能原因**
110
111传输数据包含不支持序列化及外部引入的类型,导致序列化失败。
112
113**处理步骤**
114
115确保传输信息属于Worker支持的合法序列化对象,支持的序列化类型详查[ArkTS线程间通信概述](../../arkts-utils/interthread-communication-overview.md
116)。
117
118## 10200007 Worker文件路径异常
119
120**错误信息**
121
122The worker file path is invalid.
123
124**错误描述**
125
126文件路径异常,无法正确加载Worker。
127
128**可能原因**
129
130Worker文件路径异常导致无法正常编译生成合法的worker.abc131
132**处理步骤**
133
134确保Worker文件路径符合创建Worker对象的规范,参见API参考中[constructor<sup>9+</sup>](js-apis-worker.md#constructor9)接口的示例。
135
136## 10200009 Buffer的长度错误
137
138**错误信息**
139
140The buffer size must be a multiple of ${size}.
141
142**错误描述**
143
144Buffer的长度错误,不符合要求。
145
146**可能原因**
147
148Buffer的长度错误,不符合要求。Buffer长度要求为size的整数倍。其中size为16-bits、32-bits或者64-bits。
149
150**处理步骤**
151
152确保Buffer长度符合要求。
153Buffer长度要求为size的整数倍。其中size为16-bits、32-bits或者64-bits。
154
155## 10200010 容器为空
156
157**错误信息**
158
159The container is empty.
160
161**错误描述**
162
163操作的容器为空。
164
165**可能原因**
166
167操作的容器为空,未添加相关元素。
168
169**处理步骤**
170
171确保操作的容器不为空,空容器请先向容器内添加元素。
172
173## 10200011 传入的this.object不是容器类的实例
174
175**错误信息**
176
177The {methodName} method cannot be bound.
178
179**错误描述**
180
181调用语言容器类的方法时,传入的this.object不是容器类的实例语言,容器类的方法不支持bind。
182
183**可能原因**
184
185容器类的方法不支持bind。
186
187**处理步骤**
188
1891. 检查是否使用bind API调用语言容器类的方法。
1902. 检查是否把语言容器类的方法赋值给不是语言容器实例的对象来调用。
191
192## 10200012 构造函数调用异常
193
194**错误信息**
195
196The {className}'s constructor cannot be directly invoked.
197
198**错误描述**
199
200构造语言容器类的构造方法不支持直接调用。
201
202**可能原因**
203
204调用构造函数时未使用new关键字。
205
206**处理步骤**
207
208检查是否使用直接调用了语言容器类的方法,建议使用new关键字创建语言容器类。
209
210## 10200013 只读属性设置错误
211
212**错误信息**
213
214${propertyName} cannot be set for the buffer that has only a getter.
215
216**错误描述**
217
218Buffer的属性${propertyName}只读,不能进行设置。
219
220**可能原因**
221
222对Buffer的只读属性进行设置,导致异常。
223
224**处理步骤**
225
226不要对Buffer只读属性进行相关设置。
227
228## 10200014 非Concurrent函数错误
229
230**错误信息**
231
232The function is not marked as concurrent.
233
234**错误描述**
235
236Function未被标记为concurrent。
237
238**可能原因**
239
240任务池执行的任务所需的函数未添加@Concurrent。
241
242**处理步骤**
243
244检查任务池执行的任务所需的函数,并补上@Concurrent装饰器。
245
246## 10200015 取消不存在的任务错误
247
248**错误信息**
249
250The task to cancel does not exist.
251
252**错误描述**
253
254取消一个不存在的任务。
255
256**可能原因**
257
258取消任务时,该任务并不存在于任务池中。
259
260**处理步骤**
261
262取消任务前,确保任务已被[taskpool.execute](js-apis-taskpool.md#taskpoolexecute-1)调用进入任务池且任务未执行完成。无法保证时,需要捕获异常。
263
264## 10200016 取消正在执行的任务错误
265
266**错误信息**
267
268The task to cancel is being executed.
269
270**错误描述**
271
272取消正在执行的任务。
273
274**可能原因**
275
276取消任务时,该任务已经处于执行状态。
277
278**处理步骤**
279
280取消任务前,确保任务已被[taskpool.execute](js-apis-taskpool.md#taskpoolexecute-1)调用进入任务池且任务未开始执行。无法保证时,需要捕获异常。
281
282## 10200017 删除不存在的元素错误
283
284**错误信息**
285
286The element does not exist in this container.
287
288**错误描述**
289
290删除的元素不存在此容器中。
291
292**可能原因**
293
294删除元素时,此容器中不存在此元素。
295
296**处理步骤**
297
298删除元素前,确保元素存在于此容器中。
299
300## 10200018 取消不存在的任务组错误
301
302**错误信息**
303
304The task group to cancel does not exist.
305
306**错误描述**
307
308取消一个不存在的任务组。
309
310**可能原因**
311
312取消任务组时,该任务组并不存在于任务池中。
313
314**处理步骤**
315
316取消任务组前,确保任务组已被[taskpool.execute](js-apis-taskpool.md#taskpoolexecute10)调用进入任务池且任务组内存在任务未执行完成。无法保证时,需要捕获异常。
317
318## 10200019 调用未注册对象的方法错误
319
320**错误信息**
321
322The globalCallObject is not registered.
323
324**错误描述**
325
326查询的对象未被注册。
327
328**可能原因**
329
330宿主线程Worker实例上没有注册过对应名称的对象或该对象在调用时已经被销毁。
331
332**处理步骤**
333
334避免在未注册或已取消注册后调用该对象上的方法,如果注册或销毁行为是动态的无法判断,调用时可用try-catch机制处理。
335
336## 10200020 调用注册对象上的方法类型错误
337
338**错误信息**
339
340The method to be called is not callable or is an async method or a generator.
341
342**错误描述**
343
344调用注册对象上的方法的类型错误。
345
346**可能原因**
347
348该对象所包含的属性不是可调用的或该对象所包含的方法是异步的或该对象是由生成器函数返回的。
349
350**处理步骤**
351
352应确保该方法对应的属性是可调用的,且该方法本身或其底层不应存在异步方法。
353
354## 10200021 全局调用等待超时错误
355
356**错误信息**
357
358Waiting for a global call timed out.
359
360**错误描述**
361
362等待超时错误。
363
364**可能原因**
365
366全局调用等待结果返回的时间超过了用户设置的时长,默认为5000ms。
367
368**处理步骤**
369
370应避免调用处理时间过长的方法,比如复杂计算、文件读写等,否则会导致工作线程阻塞时间过长,运行性能差。
371
372## 10200022 未在任务池中调用的函数
373
374**错误信息**
375
376The function is not called in the TaskPool thread.
377
378**错误描述**
379
380该函数未在任务池的线程中调用。
381
382**可能原因**
383
384在UI主线程中或在非taskpool的其他线程中调用该函数。
385
386**处理步骤**
387
388调用时,确保并发函数执行在taskpool线程中。无法保证时,需要捕获异常。
389
390## 10200023 未在并发函数中调用的函数
391
392**错误信息**
393
394The function is not called in the concurrent function.
395
396**错误描述**
397
398该函数未在并发函数中调用。
399
400**可能原因**
401
402该函数在回调函数中调用。
403
404**处理步骤**
405
406调用时,确保函数调用在并发函数内部。无法保证时,需要捕获异常。
407
408## 10200024 未在宿主线程中注册的函数
409
410**错误信息**
411
412The callback is not registered on the host side.
413
414**错误描述**
415
416该函数使用时未在宿主线程注册回调函数。
417
418**可能原因**
419
420该函数使用时未在宿主线程注册回调函数。
421
422**处理步骤**
423
424调用时,确保函数在宿主线程已注册。无法保证时,需要捕获异常。
425
426## 10200025 串行队列中添加了存在依赖的任务
427
428**错误信息**
429
430dependent task not allowed.
431
432**错误描述**
433
434当前串行队列中添加了存在依赖的任务。
435
436**可能原因**
437
438当前串行队列中添加了存在依赖的任务。
439
440**处理步骤**
441
442排查找到串行队列里使用[addDependency()](js-apis-taskpool.md#adddependency11)添加依赖的任务,使用[removeDependency()](js-apis-taskpool.md#removedependency11)删除此任务的依赖。
443
444## 10200026 当前任务存在循环依赖
445
446**错误信息**
447
448There is a circular dependency.
449
450**错误描述**
451
452当前任务存在循环依赖关系。
453
454**可能原因**
455
456当前任务存在循环依赖关系。
457
458**处理步骤**
459
460排查找到循环依赖关系的相关任务,根据实际情况使用[removeDependency()](js-apis-taskpool.md#removedependency11)删除不需要的依赖关系,确保所有任务中不存在循环依赖关系。
461
462## 10200027 依赖关系不存在
463
464**错误信息**
465
466The dependency does not exist.
467
468**错误描述**
469
470依赖关系不存在。
471
472**可能原因**
473
474使用[removeDependency()](js-apis-taskpool.md#removedependency11)删除任务依赖时,依赖关系不存在。
475
476**处理步骤**
477
478调用时,确保在删除依赖之前,已经使用[addDependency()](js-apis-taskpool.md#adddependency11)成功添加依赖。无法保证时,需要捕获异常。
479
480## 10200028 延时时间小于零
481
482**错误信息**
483
484The delayTime is less than zero.
485
486**错误描述**
487
488延时时间小于零。
489
490**可能原因**
491
492给定参数[delayTime](js-apis-taskpool.md#taskpoolexecutedelayed11)的值小于零。
493
494**处理步骤**
495
496调用时,确保给定参数[delayTime](js-apis-taskpool.md#taskpoolexecutedelayed11)的值大于零。无法保证时,需要捕获异常。
497
498## 10200029 无法将ArrayBuffer同时设置为transferList和cloneList
499
500**错误信息**
501
502An ArrayBuffer cannot be set as both a transfer list and a clone list.
503
504**错误描述**
505
506不能将同一个ArrayBuffer同时设置为转移列表和克隆列表。
507
508**可能原因**
509
510在传输共享列表时,同一个ArrayBuffer既是[setTransferList](js-apis-taskpool.md#settransferlist10)的参数,又是[setCloneList](js-apis-taskpool.md#setclonelist11)的参数。
511
512**处理步骤**
513
514调用时,确保同一个ArrayBuffer只被设置为transferList或cloneList中的一种。无法保证时,需要捕获异常。
515
516## 10200030 锁不存在
517
518**错误信息**
519
520The lock does not exist.
521
522**描述**
523
524请求的锁不存在。
525
526**可能的原因**
527
528某个异步锁函数使用了一个不正确的锁名称作为参数。
529
530**处理步骤**
531
532确保在调用接口时,使用正确的锁名称。
533
534## 10200031 lockAsync超时
535
536**错误信息**
537
538Timeout exceeded.
539
540**描述**
541
542[lockAsync](js-apis-arkts-utils.md#lockasync)函数在指定时间内无法获取锁。
543
544**可能的原因**
545
546某处存在死锁。
547
548**处理步骤**
549
550检查锁之间是否存在循环依赖。尝试在[lockAsync](js-apis-arkts-utils.md#lockasync)调用中添加catch语句,并查看错误信息。错误信息将包含有关现有异步锁实例和可能的死锁警告的信息。
551
552## 10200201 Concurrent修改错误
553
554**错误信息**
555
556Concurrent modification error.
557
558**错误描述**
559
560并发修改错误。
561
562**可能原因**
563
564使用collections提供的非并发安全的容器时,多个并发实例同时修改容器产生的结果是未定义的。
565
566**处理步骤**
567
568使用collections提供的非并发安全的容器时,使用异步锁进行保护。
569
570## 10200034 监听任务未注册回调函数
571
572**错误信息**
573
574The executed task does not support the registration of listeners.
575
576**错误描述**
577
578执行的任务不支持注册监听器。
579
580**可能原因**
581
582未注册回调函数或在执行任务之后注册回调函数。
583
584**处理步骤**
585
586确保在任务执行之前注册回调函数。
587
588## 10200035 doWrite接口未实现
589
590**错误信息**
591
592The doWrite method has not been implemented.
593
594**错误描述**
595
596doWrite接口未实现。
597
598**可能原因**
599
600继承Writable类,未实现[doWrite](js-apis-stream.md#dowrite)接口。
601
602**处理步骤**
603
604在继承类中实现doWrite接口函数。
605
606## 10200036 流已经结束仍进行写操作
607
608**错误信息**
609
610The stream has been ended.
611
612**错误描述**
613
614流已经结束仍然进行写操作。
615
616**可能原因**
617
618调用[end](js-apis-stream.md#end)接口之后仍进行数据写操作。
619
620**处理步骤**
621
622调整调用接口的顺序,在end之后不进行写操作。
623
624## 10200037 多次调用callback
625
626**错误信息**
627
628The callback is invoked multiple times consecutively.
629
630**错误描述**
631
632多次调用callback回调函数。
633
634**可能原因**
635
636实现[doWrite](js-apis-stream.md#dowrite)接口,并且在一次写入时多次调用callback。
637
638**处理步骤**
639
640检查[doWrite](js-apis-stream.md#dowrite)接口实现,排除一次写入多次调用callback的情况。
641
642## 10200038 doRead接口未实现
643
644**错误信息**
645
646The doRead method has not been implemented.
647
648**错误描述**
649
650doRead接口未实现。
651
652**可能原因**
653
654继承Readable类,未实现[doRead](js-apis-stream.md#doread)接口。
655
656**处理步骤**
657
658在继承类中实现doRead接口函数。
659
660## 10200039 doTransform接口未实现
661
662**错误信息**
663
664The doTransform method has not been implemented for a class that inherits from Transform.
665
666**错误描述**
667
668doTransform接口未实现。
669
670**可能原因**
671
672继承Transform类,未实现[doTransform](js-apis-stream.md#dotransform)接口。
673
674**处理步骤**
675
676在继承类中实现doTransform接口函数。
677
678## 10200050 并发任务已执行,无法周期执行
679
680**错误信息**
681
682The concurrent task has been executed and cannot be executed periodically.
683
684**错误描述**
685
686并发任务已执行,无法周期执行。
687
688**可能原因**
689
690在调用[executePeriodically](../apis-arkts/js-apis-taskpool.md#taskpoolexecuteperiodically12)执行周期任务前,该任务已经执行。
691
692**处理步骤**
693
694调用上述接口时,确保需要执行的任务未被执行。无法保证时,需要捕获异常。
695
696## 10200051 无法再次执行周期任务
697
698**错误信息**
699
700The periodic task cannot be executed again.
701
702**错误描述**
703
704无法再次执行周期任务。
705
706**可能原因**
707
708周期任务再次调用[execute](../apis-arkts/js-apis-taskpool.md#execute11)、[executeDelayed](../apis-arkts/js-apis-taskpool.md#taskpoolexecutedelayed11)、[addTask](../apis-arkts/js-apis-taskpool.md#addtask10-1)和[execute](../apis-arkts/js-apis-taskpool.md#taskpoolexecute-1)执行。
709
710**处理步骤**
711
712调用上述接口时,确保任务不是周期任务。无法保证时,需要捕获异常。
713
714## 10200052 周期性任务不能具有依赖项
715
716**错误信息**
717
718The periodic task cannot have a dependency.
719
720**错误描述**
721
722周期性任务不能具有依赖项。
723
724**可能原因**
725
726调用了[removeDependency](../apis-arkts/js-apis-taskpool.md#removedependency11)和[addDependency](js-apis-taskpool.md#adddependency11)接口给周期任务增加或移除依赖关系。
727
728**处理步骤**
729
730调用上述接口时,确保任务不是周期任务。无法保证时,需要捕获异常。
731
732## 10200060 超出精度限制
733
734**错误信息**
735
736Precision limit exceeded.
737
738**错误描述**
739
740Decimal函数使用错误。
741
742**可能原因**
743
744使用Decimal提供的函数超出精度限制。有以下函数会抛出这个错误码:[pow](js-apis-arkts-decimal.md#pow)、[exp](js-apis-arkts-decimal.md#exp)、[log](js-apis-arkts-decimal.md#log)、[ln](js-apis-arkts-decimal.md#ln)、[acos](js-apis-arkts-decimal.md#acos)、[asin](js-apis-arkts-decimal.md#asin)、[atan](js-apis-arkts-decimal.md#atan)、[acosh](js-apis-arkts-decimal.md#acosh)、[asinh](js-apis-arkts-decimal.md#asinh)、[atanh](js-apis-arkts-decimal.md#atanh)、[log2](js-apis-arkts-decimal.md#log2)、[log10](js-apis-arkts-decimal.md#log10)、[atan2](js-apis-arkts-decimal.md#atan2)。
745
746**处理步骤**
747
748使用[Decimal.set](js-apis-arkts-decimal.md#set)函数来设置有效精度。
749
750如:Decimal.set({ precision: 10 }), 设置有效精度。
751
752## 10200061 加密方法不可用
753
754**错误信息**
755
756crypto unavailable.
757
758**错误描述**
759
760Decimal函数使用错误。
761
762**可能原因**
763
764在Decimal中设置[crypto](js-apis-arkts-decimal.md#decimalconfig)或使用[Decimal.random](js-apis-arkts-decimal.md#random)函数时,使用加密方法失败。
765
766**处理步骤**
767
768使用[Decimal.set](js-apis-arkts-decimal.md#set)函数来取消加密算法。
769
770如:Decimal.set({ crypto: false}), 取消加密算法。