1# 字符串编解码<a name="ZH-CN_TOPIC_0000001210366345"></a> 2 3> **说明：** 4>从 API Version 7 开始支持。 5 6## 导入模块<a name="zh-cn_topic_0000001210206021_s56d19203690d4782bfc74069abb6bd71"></a> 7 8``` 9import util from '@ohos.util' 10``` 11 12## 权限<a name="zh-cn_topic_0000001210206021_section11257113618419"></a> 13 14无 15 16## util.printf<a name="zh-cn_topic_0000001210206021_section192192415554"></a> 17 18printf\(format: string, ...args: Object\[\]\): string 19 20通过式样化字符串对输入的内容按特定格式输出。 21 22- 参数： 23 24 <a name="zh-cn_topic_0000001210206021_table69661135912"></a> 25 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row149668318915"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p7966738914"><a name="zh-cn_topic_0000001210206021_p7966738914"></a><a name="zh-cn_topic_0000001210206021_p7966738914"></a>参数名</p> 26 </th> 27 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p296713699"><a name="zh-cn_topic_0000001210206021_p296713699"></a><a name="zh-cn_topic_0000001210206021_p296713699"></a>类型</p> 28 </th> 29 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p196718315911"><a name="zh-cn_topic_0000001210206021_p196718315911"></a><a name="zh-cn_topic_0000001210206021_p196718315911"></a>必填</p> 30 </th> 31 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p9967231197"><a name="zh-cn_topic_0000001210206021_p9967231197"></a><a name="zh-cn_topic_0000001210206021_p9967231197"></a>说明</p> 32 </th> 33 </tr> 34 </thead> 35 <tbody><tr id="zh-cn_topic_0000001210206021_row99671533914"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p79671633910"><a name="zh-cn_topic_0000001210206021_p79671633910"></a><a name="zh-cn_topic_0000001210206021_p79671633910"></a>format</p> 36 </td> 37 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p11967433914"><a name="zh-cn_topic_0000001210206021_p11967433914"></a><a name="zh-cn_topic_0000001210206021_p11967433914"></a>string</p> 38 </td> 39 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p19671336916"><a name="zh-cn_topic_0000001210206021_p19671336916"></a><a name="zh-cn_topic_0000001210206021_p19671336916"></a>是</p> 40 </td> 41 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p18899105910192"><a name="zh-cn_topic_0000001210206021_p18899105910192"></a><a name="zh-cn_topic_0000001210206021_p18899105910192"></a>式样化字符串。</p> 42 </td> 43 </tr> 44 <tr id="zh-cn_topic_0000001210206021_row18967831393"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p13702016205012"><a name="zh-cn_topic_0000001210206021_p13702016205012"></a><a name="zh-cn_topic_0000001210206021_p13702016205012"></a>...args</p> 45 </td> 46 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p478592912504"><a name="zh-cn_topic_0000001210206021_p478592912504"></a><a name="zh-cn_topic_0000001210206021_p478592912504"></a>Object[]</p> 47 </td> 48 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p149671932919"><a name="zh-cn_topic_0000001210206021_p149671932919"></a><a name="zh-cn_topic_0000001210206021_p149671932919"></a>否</p> 49 </td> 50 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p14582313152114"><a name="zh-cn_topic_0000001210206021_p14582313152114"></a><a name="zh-cn_topic_0000001210206021_p14582313152114"></a>待式样化数据。</p> 51 </td> 52 </tr> 53 </tbody> 54 </table> 55 56- 返回值： 57 58 <a name="zh-cn_topic_0000001210206021_table16391145317913"></a> 59 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row2391145319910"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p13911353991"><a name="zh-cn_topic_0000001210206021_p13911353991"></a><a name="zh-cn_topic_0000001210206021_p13911353991"></a>类型</p> 60 </th> 61 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p193911531395"><a name="zh-cn_topic_0000001210206021_p193911531395"></a><a name="zh-cn_topic_0000001210206021_p193911531395"></a>说明</p> 62 </th> 63 </tr> 64 </thead> 65 <tbody><tr id="zh-cn_topic_0000001210206021_row1339114531391"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p16358176115311"><a name="zh-cn_topic_0000001210206021_p16358176115311"></a><a name="zh-cn_topic_0000001210206021_p16358176115311"></a>string</p> 66 </td> 67 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p107511844112312"><a name="zh-cn_topic_0000001210206021_p107511844112312"></a><a name="zh-cn_topic_0000001210206021_p107511844112312"></a>按特定格式式样化后的字符串。</p> 68 </td> 69 </tr> 70 </tbody> 71 </table> 72 73- 示例： 74 75 ``` 76 var res = util.printf("%s", "hello world!"); 77 console.log(res); 78 ``` 79 80 81## util.getErrorString<a name="zh-cn_topic_0000001210206021_section858912895313"></a> 82 83getErrorString\(errno: number\): string 84 85获取系统错误码对应的详细信息。 86 87- 参数： 88 89 <a name="zh-cn_topic_0000001210206021_table55891528185315"></a> 90 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row115891228145313"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p35901828175317"><a name="zh-cn_topic_0000001210206021_p35901828175317"></a><a name="zh-cn_topic_0000001210206021_p35901828175317"></a>参数名</p> 91 </th> 92 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p18590152820538"><a name="zh-cn_topic_0000001210206021_p18590152820538"></a><a name="zh-cn_topic_0000001210206021_p18590152820538"></a>类型</p> 93 </th> 94 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p95900289534"><a name="zh-cn_topic_0000001210206021_p95900289534"></a><a name="zh-cn_topic_0000001210206021_p95900289534"></a>必填</p> 95 </th> 96 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p1359016288531"><a name="zh-cn_topic_0000001210206021_p1359016288531"></a><a name="zh-cn_topic_0000001210206021_p1359016288531"></a>说明</p> 97 </th> 98 </tr> 99 </thead> 100 <tbody><tr id="zh-cn_topic_0000001210206021_row6590122819538"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p17590428115313"><a name="zh-cn_topic_0000001210206021_p17590428115313"></a><a name="zh-cn_topic_0000001210206021_p17590428115313"></a>errno</p> 101 </td> 102 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p13405179222"><a name="zh-cn_topic_0000001210206021_p13405179222"></a><a name="zh-cn_topic_0000001210206021_p13405179222"></a>number</p> 103 </td> 104 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p959032865319"><a name="zh-cn_topic_0000001210206021_p959032865319"></a><a name="zh-cn_topic_0000001210206021_p959032865319"></a>是</p> 105 </td> 106 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p95901128125320"><a name="zh-cn_topic_0000001210206021_p95901128125320"></a><a name="zh-cn_topic_0000001210206021_p95901128125320"></a>系统发生错误产生的错误码。</p> 107 </td> 108 </tr> 109 </tbody> 110 </table> 111 112- 返回值： 113 114 <a name="zh-cn_topic_0000001210206021_table959218285533"></a> 115 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row259252820539"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p175921928175319"><a name="zh-cn_topic_0000001210206021_p175921928175319"></a><a name="zh-cn_topic_0000001210206021_p175921928175319"></a>类型</p> 116 </th> 117 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p1759262819538"><a name="zh-cn_topic_0000001210206021_p1759262819538"></a><a name="zh-cn_topic_0000001210206021_p1759262819538"></a>说明</p> 118 </th> 119 </tr> 120 </thead> 121 <tbody><tr id="zh-cn_topic_0000001210206021_row15592142812531"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p959252813537"><a name="zh-cn_topic_0000001210206021_p959252813537"></a><a name="zh-cn_topic_0000001210206021_p959252813537"></a>string</p> 122 </td> 123 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p459272810535"><a name="zh-cn_topic_0000001210206021_p459272810535"></a><a name="zh-cn_topic_0000001210206021_p459272810535"></a>错误码对应的详细信息。</p> 124 </td> 125 </tr> 126 </tbody> 127 </table> 128 129- 示例： 130 131 ``` 132 var errnum = 10; // 10：a system error number 133 var result = util.getErrorString(errnum); 134 console.log("result = " + result); 135 ``` 136 137 138## util.callbackWrapper<a name="zh-cn_topic_0000001210206021_section15594104112592"></a> 139 140callbackWrapper\(original: Function\): \(err: Object, value: Object\)=\>void 141 142对异步函数进行回调化处理，回调中第一个参数将是拒绝原因（如果 Promise 已解决，则为 null），第二个参数将是已解决的值。 143 144- 参数： 145 146 <a name="zh-cn_topic_0000001210206021_table8595841155910"></a> 147 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row45953415598"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p15953414591"><a name="zh-cn_topic_0000001210206021_p15953414591"></a><a name="zh-cn_topic_0000001210206021_p15953414591"></a>参数名</p> 148 </th> 149 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p2596144175918"><a name="zh-cn_topic_0000001210206021_p2596144175918"></a><a name="zh-cn_topic_0000001210206021_p2596144175918"></a>类型</p> 150 </th> 151 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p35961341115918"><a name="zh-cn_topic_0000001210206021_p35961341115918"></a><a name="zh-cn_topic_0000001210206021_p35961341115918"></a>必填</p> 152 </th> 153 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p105966412596"><a name="zh-cn_topic_0000001210206021_p105966412596"></a><a name="zh-cn_topic_0000001210206021_p105966412596"></a>说明</p> 154 </th> 155 </tr> 156 </thead> 157 <tbody><tr id="zh-cn_topic_0000001210206021_row12596124113592"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p19596174135912"><a name="zh-cn_topic_0000001210206021_p19596174135912"></a><a name="zh-cn_topic_0000001210206021_p19596174135912"></a>original</p> 158 </td> 159 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p020217118113"><a name="zh-cn_topic_0000001210206021_p020217118113"></a><a name="zh-cn_topic_0000001210206021_p020217118113"></a>Function</p> 160 </td> 161 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p2596154118591"><a name="zh-cn_topic_0000001210206021_p2596154118591"></a><a name="zh-cn_topic_0000001210206021_p2596154118591"></a>是</p> 162 </td> 163 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p1471526810"><a name="zh-cn_topic_0000001210206021_p1471526810"></a><a name="zh-cn_topic_0000001210206021_p1471526810"></a>异步函数。</p> 164 </td> 165 </tr> 166 </tbody> 167 </table> 168 169- 返回值： 170 171 <a name="zh-cn_topic_0000001210206021_table3598104111591"></a> 172 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row16598144112599"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p20598144115597"><a name="zh-cn_topic_0000001210206021_p20598144115597"></a><a name="zh-cn_topic_0000001210206021_p20598144115597"></a>类型</p> 173 </th> 174 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p4598114135912"><a name="zh-cn_topic_0000001210206021_p4598114135912"></a><a name="zh-cn_topic_0000001210206021_p4598114135912"></a>说明</p> 175 </th> 176 </tr> 177 </thead> 178 <tbody><tr id="zh-cn_topic_0000001210206021_row059994114593"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p15521135919118"><a name="zh-cn_topic_0000001210206021_p15521135919118"></a><a name="zh-cn_topic_0000001210206021_p15521135919118"></a>Function</p> 179 </td> 180 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p1759984114595"><a name="zh-cn_topic_0000001210206021_p1759984114595"></a><a name="zh-cn_topic_0000001210206021_p1759984114595"></a>返回一个第一个参数是拒绝原因（如果 Promise 已解决，则为 null），第二个参数是已解决的回调函数。</p> 181 </td> 182 </tr> 183 </tbody> 184 </table> 185 186- 示例： 187 188 ``` 189 async function promiseFn() { 190 return Promise.reject('value'); 191 } 192 var cb = util.callbackWrapper(promiseFn); 193 cb((err, ret) => { 194 expect(err).strictEqual('value'); 195 expect(ret).strictEqual(undefined); 196 }) 197 ``` 198 199 200## util.promiseWrapper<a name="zh-cn_topic_0000001210206021_section172381917987"></a> 201 202promiseWrapper\(original: \(err: Object, value: Object\) =\> void\): Object 203 204对异步函数处理并返回一个promise的版本。 205 206- 参数： 207 208 <a name="zh-cn_topic_0000001210206021_table1239191711810"></a> 209 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row423919171389"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p823941711816"><a name="zh-cn_topic_0000001210206021_p823941711816"></a><a name="zh-cn_topic_0000001210206021_p823941711816"></a>参数名</p> 210 </th> 211 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p15240017482"><a name="zh-cn_topic_0000001210206021_p15240017482"></a><a name="zh-cn_topic_0000001210206021_p15240017482"></a>类型</p> 212 </th> 213 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p624015171185"><a name="zh-cn_topic_0000001210206021_p624015171185"></a><a name="zh-cn_topic_0000001210206021_p624015171185"></a>必填</p> 214 </th> 215 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p22403179814"><a name="zh-cn_topic_0000001210206021_p22403179814"></a><a name="zh-cn_topic_0000001210206021_p22403179814"></a>说明</p> 216 </th> 217 </tr> 218 </thead> 219 <tbody><tr id="zh-cn_topic_0000001210206021_row9240141716812"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p1124019171984"><a name="zh-cn_topic_0000001210206021_p1124019171984"></a><a name="zh-cn_topic_0000001210206021_p1124019171984"></a>original</p> 220 </td> 221 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p32401617886"><a name="zh-cn_topic_0000001210206021_p32401617886"></a><a name="zh-cn_topic_0000001210206021_p32401617886"></a>Function</p> 222 </td> 223 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p990643291112"><a name="zh-cn_topic_0000001210206021_p990643291112"></a><a name="zh-cn_topic_0000001210206021_p990643291112"></a>是</p> 224 </td> 225 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p69671631796"><a name="zh-cn_topic_0000001210206021_p69671631796"></a><a name="zh-cn_topic_0000001210206021_p69671631796"></a>异步函数。</p> 226 </td> 227 </tr> 228 </tbody> 229 </table> 230 231- 返回值： 232 233 <a name="zh-cn_topic_0000001210206021_table17243191712818"></a> 234 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row62431017981"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p11243617785"><a name="zh-cn_topic_0000001210206021_p11243617785"></a><a name="zh-cn_topic_0000001210206021_p11243617785"></a>类型</p> 235 </th> 236 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p172431317182"><a name="zh-cn_topic_0000001210206021_p172431317182"></a><a name="zh-cn_topic_0000001210206021_p172431317182"></a>说明</p> 237 </th> 238 </tr> 239 </thead> 240 <tbody><tr id="zh-cn_topic_0000001210206021_row1243201714811"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p73929531797"><a name="zh-cn_topic_0000001210206021_p73929531797"></a><a name="zh-cn_topic_0000001210206021_p73929531797"></a>Function</p> 241 </td> 242 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p125051140151213"><a name="zh-cn_topic_0000001210206021_p125051140151213"></a><a name="zh-cn_topic_0000001210206021_p125051140151213"></a>采用遵循常见的错误优先的回调风格的函数（也就是将 (err, value) => ... 回调作为最后一个参数），并返回一个返回 promise 的版本。</p> 243 </td> 244 </tr> 245 </tbody> 246 </table> 247 248- 示例： 249 250 ``` 251 function aysnFun(str1, str2, callback) { 252 if (typeof str1 === 'string' && typeof str1 === 'string') { 253 callback(null, str1 + str2); 254 } else { 255 callback('type err'); 256 } 257 } 258 let newPromiseObj = util.promiseWrapper(aysnFun)("Hello", 'World'); 259 newPromiseObj.then(res => { 260 expect(res).strictEqual('HelloWorld'); 261 }) 262 ``` 263 264 265## TextDecoder<a name="zh-cn_topic_0000001210206021_section143808167355"></a> 266 267### 属性<a name="zh-cn_topic_0000001210206021_section18482944113517"></a> 268 269<a name="zh-cn_topic_0000001210206021_table20482104463514"></a> 270<table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row1348214444357"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001210206021_p184822443351"><a name="zh-cn_topic_0000001210206021_p184822443351"></a><a name="zh-cn_topic_0000001210206021_p184822443351"></a>名称</p> 271</th> 272<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001210206021_p1648254415353"><a name="zh-cn_topic_0000001210206021_p1648254415353"></a><a name="zh-cn_topic_0000001210206021_p1648254415353"></a>参数类型</p> 273</th> 274<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001210206021_p9482124413355"><a name="zh-cn_topic_0000001210206021_p9482124413355"></a><a name="zh-cn_topic_0000001210206021_p9482124413355"></a>可读</p> 275</th> 276<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001210206021_p3482124493515"><a name="zh-cn_topic_0000001210206021_p3482124493515"></a><a name="zh-cn_topic_0000001210206021_p3482124493515"></a>可写</p> 277</th> 278<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001210206021_p12482104483513"><a name="zh-cn_topic_0000001210206021_p12482104483513"></a><a name="zh-cn_topic_0000001210206021_p12482104483513"></a>说明</p> 279</th> 280</tr> 281</thead> 282<tbody><tr id="zh-cn_topic_0000001210206021_row148254473513"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001210206021_p2482444163514"><a name="zh-cn_topic_0000001210206021_p2482444163514"></a><a name="zh-cn_topic_0000001210206021_p2482444163514"></a>encoding</p> 283</td> 284<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001210206021_p3482124417356"><a name="zh-cn_topic_0000001210206021_p3482124417356"></a><a name="zh-cn_topic_0000001210206021_p3482124417356"></a>string</p> 285</td> 286<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001210206021_p16483194443514"><a name="zh-cn_topic_0000001210206021_p16483194443514"></a><a name="zh-cn_topic_0000001210206021_p16483194443514"></a>是</p> 287</td> 288<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001210206021_p64838449351"><a name="zh-cn_topic_0000001210206021_p64838449351"></a><a name="zh-cn_topic_0000001210206021_p64838449351"></a>否</p> 289</td> 290<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001210206021_p164831444113515"><a name="zh-cn_topic_0000001210206021_p164831444113515"></a><a name="zh-cn_topic_0000001210206021_p164831444113515"></a>编码格式。</p> 291</td> 292</tr> 293<tr id="zh-cn_topic_0000001210206021_row1483164414352"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001210206021_p17483184419352"><a name="zh-cn_topic_0000001210206021_p17483184419352"></a><a name="zh-cn_topic_0000001210206021_p17483184419352"></a>fatal</p> 294</td> 295<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001210206021_p9483184410355"><a name="zh-cn_topic_0000001210206021_p9483184410355"></a><a name="zh-cn_topic_0000001210206021_p9483184410355"></a>boolean</p> 296</td> 297<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001210206021_p1348384415359"><a name="zh-cn_topic_0000001210206021_p1348384415359"></a><a name="zh-cn_topic_0000001210206021_p1348384415359"></a>是</p> 298</td> 299<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001210206021_p1448312449355"><a name="zh-cn_topic_0000001210206021_p1448312449355"></a><a name="zh-cn_topic_0000001210206021_p1448312449355"></a>否</p> 300</td> 301<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001210206021_p8483124473515"><a name="zh-cn_topic_0000001210206021_p8483124473515"></a><a name="zh-cn_topic_0000001210206021_p8483124473515"></a>是否显示致命错误。</p> 302</td> 303</tr> 304<tr id="zh-cn_topic_0000001210206021_row13483164419353"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001210206021_p4483154463514"><a name="zh-cn_topic_0000001210206021_p4483154463514"></a><a name="zh-cn_topic_0000001210206021_p4483154463514"></a>ignoreBOM</p> 305</td> 306<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001210206021_p4483174443517"><a name="zh-cn_topic_0000001210206021_p4483174443517"></a><a name="zh-cn_topic_0000001210206021_p4483174443517"></a>boolean</p> 307</td> 308<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001210206021_p1483134419353"><a name="zh-cn_topic_0000001210206021_p1483134419353"></a><a name="zh-cn_topic_0000001210206021_p1483134419353"></a>是</p> 309</td> 310<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001210206021_p648354483510"><a name="zh-cn_topic_0000001210206021_p648354483510"></a><a name="zh-cn_topic_0000001210206021_p648354483510"></a>否</p> 311</td> 312<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001210206021_p348319442351"><a name="zh-cn_topic_0000001210206021_p348319442351"></a><a name="zh-cn_topic_0000001210206021_p348319442351"></a>是否忽略BOM（byte order marker）标记，默认值是false。</p> 313</td> 314</tr> 315</tbody> 316</table> 317 318### constructor<a name="zh-cn_topic_0000001210206021_section6179915133611"></a> 319 320constructor\(encoding?: string, options?: \{ fatal?: boolean; ignoreBOM?: boolean \},\) 321 322TextDecoder的构造函数。 323 324- 参数： 325 326 <a name="zh-cn_topic_0000001210206021_table51212237384"></a> 327 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row1512182373816"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p5121112319386"><a name="zh-cn_topic_0000001210206021_p5121112319386"></a><a name="zh-cn_topic_0000001210206021_p5121112319386"></a>参数名</p> 328 </th> 329 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p1712122383810"><a name="zh-cn_topic_0000001210206021_p1712122383810"></a><a name="zh-cn_topic_0000001210206021_p1712122383810"></a>类型</p> 330 </th> 331 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p712112373813"><a name="zh-cn_topic_0000001210206021_p712112373813"></a><a name="zh-cn_topic_0000001210206021_p712112373813"></a>必填</p> 332 </th> 333 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p71218236389"><a name="zh-cn_topic_0000001210206021_p71218236389"></a><a name="zh-cn_topic_0000001210206021_p71218236389"></a>说明</p> 334 </th> 335 </tr> 336 </thead> 337 <tbody><tr id="zh-cn_topic_0000001210206021_row2121923123819"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p112132393816"><a name="zh-cn_topic_0000001210206021_p112132393816"></a><a name="zh-cn_topic_0000001210206021_p112132393816"></a>encoding</p> 338 </td> 339 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p1212102383818"><a name="zh-cn_topic_0000001210206021_p1212102383818"></a><a name="zh-cn_topic_0000001210206021_p1212102383818"></a>string</p> 340 </td> 341 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p6121323143812"><a name="zh-cn_topic_0000001210206021_p6121323143812"></a><a name="zh-cn_topic_0000001210206021_p6121323143812"></a>否</p> 342 </td> 343 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p16121182313387"><a name="zh-cn_topic_0000001210206021_p16121182313387"></a><a name="zh-cn_topic_0000001210206021_p16121182313387"></a>编码格式。</p> 344 </td> 345 </tr> 346 <tr id="zh-cn_topic_0000001210206021_row512116231383"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p141211823113818"><a name="zh-cn_topic_0000001210206021_p141211823113818"></a><a name="zh-cn_topic_0000001210206021_p141211823113818"></a>options</p> 347 </td> 348 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p81221923163816"><a name="zh-cn_topic_0000001210206021_p81221923163816"></a><a name="zh-cn_topic_0000001210206021_p81221923163816"></a>Object</p> 349 </td> 350 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p201229236384"><a name="zh-cn_topic_0000001210206021_p201229236384"></a><a name="zh-cn_topic_0000001210206021_p201229236384"></a>否</p> 351 </td> 352 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p7122142317382"><a name="zh-cn_topic_0000001210206021_p7122142317382"></a><a name="zh-cn_topic_0000001210206021_p7122142317382"></a>编码相关选项参数，存在两个属性fatal和ignoreBOM。</p> 353 </td> 354 </tr> 355 </tbody> 356 </table> 357 358 **表 1** options 359 360 <a name="zh-cn_topic_0000001210206021_table468420114018"></a> 361 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row1768412134017"><th class="cellrowborder" valign="top" width="17.549999999999997%" id="mcps1.2.5.1.1"><p id="zh-cn_topic_0000001210206021_p86842124013"><a name="zh-cn_topic_0000001210206021_p86842124013"></a><a name="zh-cn_topic_0000001210206021_p86842124013"></a>名称</p> 362 </th> 363 <th class="cellrowborder" valign="top" width="16.03%" id="mcps1.2.5.1.2"><p id="zh-cn_topic_0000001210206021_p16848194014"><a name="zh-cn_topic_0000001210206021_p16848194014"></a><a name="zh-cn_topic_0000001210206021_p16848194014"></a>参数类型</p> 364 </th> 365 <th class="cellrowborder" valign="top" width="11.16%" id="mcps1.2.5.1.3"><p id="zh-cn_topic_0000001210206021_p146848118406"><a name="zh-cn_topic_0000001210206021_p146848118406"></a><a name="zh-cn_topic_0000001210206021_p146848118406"></a>必填</p> 366 </th> 367 <th class="cellrowborder" valign="top" width="55.26%" id="mcps1.2.5.1.4"><p id="zh-cn_topic_0000001210206021_p66848113409"><a name="zh-cn_topic_0000001210206021_p66848113409"></a><a name="zh-cn_topic_0000001210206021_p66848113409"></a>说明</p> 368 </th> 369 </tr> 370 </thead> 371 <tbody><tr id="zh-cn_topic_0000001210206021_row96841013407"><td class="cellrowborder" valign="top" width="17.549999999999997%" headers="mcps1.2.5.1.1 "><p id="zh-cn_topic_0000001210206021_p126849184010"><a name="zh-cn_topic_0000001210206021_p126849184010"></a><a name="zh-cn_topic_0000001210206021_p126849184010"></a>fatal</p> 372 </td> 373 <td class="cellrowborder" valign="top" width="16.03%" headers="mcps1.2.5.1.2 "><p id="zh-cn_topic_0000001210206021_p368421104017"><a name="zh-cn_topic_0000001210206021_p368421104017"></a><a name="zh-cn_topic_0000001210206021_p368421104017"></a>boolean</p> 374 </td> 375 <td class="cellrowborder" valign="top" width="11.16%" headers="mcps1.2.5.1.3 "><p id="zh-cn_topic_0000001210206021_p17684818404"><a name="zh-cn_topic_0000001210206021_p17684818404"></a><a name="zh-cn_topic_0000001210206021_p17684818404"></a>否</p> 376 </td> 377 <td class="cellrowborder" valign="top" width="55.26%" headers="mcps1.2.5.1.4 "><p id="zh-cn_topic_0000001210206021_p9845227114216"><a name="zh-cn_topic_0000001210206021_p9845227114216"></a><a name="zh-cn_topic_0000001210206021_p9845227114216"></a>是否显示致命错误。</p> 378 </td> 379 </tr> 380 <tr id="zh-cn_topic_0000001210206021_row13751843114014"><td class="cellrowborder" valign="top" width="17.549999999999997%" headers="mcps1.2.5.1.1 "><p id="zh-cn_topic_0000001210206021_p11938165615400"><a name="zh-cn_topic_0000001210206021_p11938165615400"></a><a name="zh-cn_topic_0000001210206021_p11938165615400"></a>ignoreBOM</p> 381 </td> 382 <td class="cellrowborder" valign="top" width="16.03%" headers="mcps1.2.5.1.2 "><p id="zh-cn_topic_0000001210206021_p67614394017"><a name="zh-cn_topic_0000001210206021_p67614394017"></a><a name="zh-cn_topic_0000001210206021_p67614394017"></a>boolean</p> 383 </td> 384 <td class="cellrowborder" valign="top" width="11.16%" headers="mcps1.2.5.1.3 "><p id="zh-cn_topic_0000001210206021_p1676154394020"><a name="zh-cn_topic_0000001210206021_p1676154394020"></a><a name="zh-cn_topic_0000001210206021_p1676154394020"></a>否</p> 385 </td> 386 <td class="cellrowborder" valign="top" width="55.26%" headers="mcps1.2.5.1.4 "><p id="zh-cn_topic_0000001210206021_p38458271423"><a name="zh-cn_topic_0000001210206021_p38458271423"></a><a name="zh-cn_topic_0000001210206021_p38458271423"></a>是否忽略BOM标记。</p> 387 </td> 388 </tr> 389 </tbody> 390 </table> 391 392- 示例： 393 394 ``` 395 var textDecoder = util.TextDecoder("utf-8",{ignoreBOM:true}) 396 ``` 397 398 399### decode<a name="zh-cn_topic_0000001210206021_section9594134194318"></a> 400 401decode\(input: Uint8Array, options?:\{stream?:false\}\): string 402 403通过输入参数解码后输出对应文本。 404 405- 参数： 406 407 <a name="zh-cn_topic_0000001210206021_table157841181443"></a> 408 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row10784188164412"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p167847814420"><a name="zh-cn_topic_0000001210206021_p167847814420"></a><a name="zh-cn_topic_0000001210206021_p167847814420"></a>参数名</p> 409 </th> 410 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p078418815441"><a name="zh-cn_topic_0000001210206021_p078418815441"></a><a name="zh-cn_topic_0000001210206021_p078418815441"></a>类型</p> 411 </th> 412 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p14784082449"><a name="zh-cn_topic_0000001210206021_p14784082449"></a><a name="zh-cn_topic_0000001210206021_p14784082449"></a>必填</p> 413 </th> 414 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p1878468104412"><a name="zh-cn_topic_0000001210206021_p1878468104412"></a><a name="zh-cn_topic_0000001210206021_p1878468104412"></a>说明</p> 415 </th> 416 </tr> 417 </thead> 418 <tbody><tr id="zh-cn_topic_0000001210206021_row27851385447"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p2785284442"><a name="zh-cn_topic_0000001210206021_p2785284442"></a><a name="zh-cn_topic_0000001210206021_p2785284442"></a>input</p> 419 </td> 420 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p47857813448"><a name="zh-cn_topic_0000001210206021_p47857813448"></a><a name="zh-cn_topic_0000001210206021_p47857813448"></a>Uint8Array</p> 421 </td> 422 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p147859815443"><a name="zh-cn_topic_0000001210206021_p147859815443"></a><a name="zh-cn_topic_0000001210206021_p147859815443"></a>是</p> 423 </td> 424 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p2078588194411"><a name="zh-cn_topic_0000001210206021_p2078588194411"></a><a name="zh-cn_topic_0000001210206021_p2078588194411"></a>数字。</p> 425 </td> 426 </tr> 427 <tr id="zh-cn_topic_0000001210206021_row187851287441"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p187851487447"><a name="zh-cn_topic_0000001210206021_p187851487447"></a><a name="zh-cn_topic_0000001210206021_p187851487447"></a>options</p> 428 </td> 429 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p13785987448"><a name="zh-cn_topic_0000001210206021_p13785987448"></a><a name="zh-cn_topic_0000001210206021_p13785987448"></a>Object</p> 430 </td> 431 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p1878538154411"><a name="zh-cn_topic_0000001210206021_p1878538154411"></a><a name="zh-cn_topic_0000001210206021_p1878538154411"></a>否</p> 432 </td> 433 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p127684914432"><a name="zh-cn_topic_0000001210206021_p127684914432"></a><a name="zh-cn_topic_0000001210206021_p127684914432"></a>解码相关选项参数。</p> 434 </td> 435 </tr> 436 </tbody> 437 </table> 438 439 **表 2** options 440 441 <a name="zh-cn_topic_0000001210206021_table395819335512"></a> 442 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row4958133185116"><th class="cellrowborder" valign="top" width="17.549999999999997%" id="mcps1.2.5.1.1"><p id="zh-cn_topic_0000001210206021_p1795813315511"><a name="zh-cn_topic_0000001210206021_p1795813315511"></a><a name="zh-cn_topic_0000001210206021_p1795813315511"></a>名称</p> 443 </th> 444 <th class="cellrowborder" valign="top" width="16.03%" id="mcps1.2.5.1.2"><p id="zh-cn_topic_0000001210206021_p1895883395120"><a name="zh-cn_topic_0000001210206021_p1895883395120"></a><a name="zh-cn_topic_0000001210206021_p1895883395120"></a>参数类型</p> 445 </th> 446 <th class="cellrowborder" valign="top" width="11.16%" id="mcps1.2.5.1.3"><p id="zh-cn_topic_0000001210206021_p17958633125116"><a name="zh-cn_topic_0000001210206021_p17958633125116"></a><a name="zh-cn_topic_0000001210206021_p17958633125116"></a>必填</p> 447 </th> 448 <th class="cellrowborder" valign="top" width="55.26%" id="mcps1.2.5.1.4"><p id="zh-cn_topic_0000001210206021_p15958133312518"><a name="zh-cn_topic_0000001210206021_p15958133312518"></a><a name="zh-cn_topic_0000001210206021_p15958133312518"></a>说明</p> 449 </th> 450 </tr> 451 </thead> 452 <tbody><tr id="zh-cn_topic_0000001210206021_row1958833125117"><td class="cellrowborder" valign="top" width="17.549999999999997%" headers="mcps1.2.5.1.1 "><p id="zh-cn_topic_0000001210206021_p1984204213513"><a name="zh-cn_topic_0000001210206021_p1984204213513"></a><a name="zh-cn_topic_0000001210206021_p1984204213513"></a>stream</p> 453 </td> 454 <td class="cellrowborder" valign="top" width="16.03%" headers="mcps1.2.5.1.2 "><p id="zh-cn_topic_0000001210206021_p11958733115110"><a name="zh-cn_topic_0000001210206021_p11958733115110"></a><a name="zh-cn_topic_0000001210206021_p11958733115110"></a>boolean</p> 455 </td> 456 <td class="cellrowborder" valign="top" width="11.16%" headers="mcps1.2.5.1.3 "><p id="zh-cn_topic_0000001210206021_p1995817337517"><a name="zh-cn_topic_0000001210206021_p1995817337517"></a><a name="zh-cn_topic_0000001210206021_p1995817337517"></a>否</p> 457 </td> 458 <td class="cellrowborder" valign="top" width="55.26%" headers="mcps1.2.5.1.4 "><p id="zh-cn_topic_0000001210206021_p3958113385114"><a name="zh-cn_topic_0000001210206021_p3958113385114"></a><a name="zh-cn_topic_0000001210206021_p3958113385114"></a>在随后的decode()调用中是否跟随附加数据。如果以块的形式处理数据，则设置为true；如果处理最后的块或数据未分块，则设置为false。默认为false。</p> 459 </td> 460 </tr> 461 </tbody> 462 </table> 463 464- 返回值： 465 466 <a name="zh-cn_topic_0000001210206021_table37864874412"></a> 467 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row1778638104418"><th class="cellrowborder" valign="top" width="20.990000000000002%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p1778613834415"><a name="zh-cn_topic_0000001210206021_p1778613834415"></a><a name="zh-cn_topic_0000001210206021_p1778613834415"></a>类型</p> 468 </th> 469 <th class="cellrowborder" valign="top" width="79.01%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p6786118124414"><a name="zh-cn_topic_0000001210206021_p6786118124414"></a><a name="zh-cn_topic_0000001210206021_p6786118124414"></a>说明</p> 470 </th> 471 </tr> 472 </thead> 473 <tbody><tr id="zh-cn_topic_0000001210206021_row678611818445"><td class="cellrowborder" valign="top" width="20.990000000000002%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p1278638184418"><a name="zh-cn_topic_0000001210206021_p1278638184418"></a><a name="zh-cn_topic_0000001210206021_p1278638184418"></a>string</p> 474 </td> 475 <td class="cellrowborder" valign="top" width="79.01%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p6786118144419"><a name="zh-cn_topic_0000001210206021_p6786118144419"></a><a name="zh-cn_topic_0000001210206021_p6786118144419"></a>解码后的数据。</p> 476 </td> 477 </tr> 478 </tbody> 479 </table> 480 481- 示例： 482 483 ``` 484 var textDecoder = util.TextDecoder("utf-8",{ignoreBOM:true}); 485 var result = new Uint8Array(6); 486 result[0] = 0xEF; 487 result[1] = 0xBB; 488 result[2] = 0xBF; 489 result[3] = 0x61; 490 result[4] = 0x62; 491 result[5] = 0x63; 492 console.log("input num:"); 493 for(var j= 0; j < 6; j++) { 494 console.log(result[j]); 495 } 496 var retStr = textDecoder.decode( result , {stream:false}); 497 console.log("retStr = " + retStr); 498 ``` 499 500 501## TextEncoder<a name="zh-cn_topic_0000001210206021_section7299123218370"></a> 502 503### 属性<a name="zh-cn_topic_0000001210206021_section46449515265"></a> 504 505<a name="zh-cn_topic_0000001210206021_table16644251192617"></a> 506<table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row264545172611"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001210206021_p12645145152618"><a name="zh-cn_topic_0000001210206021_p12645145152618"></a><a name="zh-cn_topic_0000001210206021_p12645145152618"></a>名称</p> 507</th> 508<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001210206021_p664635172620"><a name="zh-cn_topic_0000001210206021_p664635172620"></a><a name="zh-cn_topic_0000001210206021_p664635172620"></a>参数类型</p> 509</th> 510<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001210206021_p46461151172619"><a name="zh-cn_topic_0000001210206021_p46461151172619"></a><a name="zh-cn_topic_0000001210206021_p46461151172619"></a>可读</p> 511</th> 512<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001210206021_p264695120267"><a name="zh-cn_topic_0000001210206021_p264695120267"></a><a name="zh-cn_topic_0000001210206021_p264695120267"></a>可写</p> 513</th> 514<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001210206021_p2646175115265"><a name="zh-cn_topic_0000001210206021_p2646175115265"></a><a name="zh-cn_topic_0000001210206021_p2646175115265"></a>说明</p> 515</th> 516</tr> 517</thead> 518<tbody><tr id="zh-cn_topic_0000001210206021_row1664616519264"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001210206021_p9577155632715"><a name="zh-cn_topic_0000001210206021_p9577155632715"></a><a name="zh-cn_topic_0000001210206021_p9577155632715"></a>encoding</p> 519</td> 520<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001210206021_p146471519262"><a name="zh-cn_topic_0000001210206021_p146471519262"></a><a name="zh-cn_topic_0000001210206021_p146471519262"></a>string</p> 521</td> 522<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001210206021_p176471051112619"><a name="zh-cn_topic_0000001210206021_p176471051112619"></a><a name="zh-cn_topic_0000001210206021_p176471051112619"></a>是</p> 523</td> 524<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001210206021_p1928801914148"><a name="zh-cn_topic_0000001210206021_p1928801914148"></a><a name="zh-cn_topic_0000001210206021_p1928801914148"></a>否</p> 525</td> 526<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001210206021_p7288893020"><a name="zh-cn_topic_0000001210206021_p7288893020"></a><a name="zh-cn_topic_0000001210206021_p7288893020"></a>编码格式，默认值是utf-8。</p> 527</td> 528</tr> 529</tbody> 530</table> 531 532### constructor<a name="zh-cn_topic_0000001210206021_section19850195154719"></a> 533 534constructor\(\) 535 536TextEncoder的构造函数。 537 538- 示例： 539 540 ``` 541 var textEncoder = new util.TextEncoder() 542 ``` 543 544 545### encode<a name="zh-cn_topic_0000001210206021_section16144104844716"></a> 546 547encode\(input?: string\): Uint8Array 548 549通过输入参数编码后输出对应文本。 550 551- 参数： 552 553 <a name="zh-cn_topic_0000001210206021_table240355411539"></a> 554 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row13404135415531"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p1140485425310"><a name="zh-cn_topic_0000001210206021_p1140485425310"></a><a name="zh-cn_topic_0000001210206021_p1140485425310"></a>参数名</p> 555 </th> 556 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p134041954145318"><a name="zh-cn_topic_0000001210206021_p134041954145318"></a><a name="zh-cn_topic_0000001210206021_p134041954145318"></a>类型</p> 557 </th> 558 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p204041854135312"><a name="zh-cn_topic_0000001210206021_p204041854135312"></a><a name="zh-cn_topic_0000001210206021_p204041854135312"></a>必填</p> 559 </th> 560 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p144041854175312"><a name="zh-cn_topic_0000001210206021_p144041854175312"></a><a name="zh-cn_topic_0000001210206021_p144041854175312"></a>说明</p> 561 </th> 562 </tr> 563 </thead> 564 <tbody><tr id="zh-cn_topic_0000001210206021_row1640414544532"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p1840513545531"><a name="zh-cn_topic_0000001210206021_p1840513545531"></a><a name="zh-cn_topic_0000001210206021_p1840513545531"></a>input</p> 565 </td> 566 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p84051254195315"><a name="zh-cn_topic_0000001210206021_p84051254195315"></a><a name="zh-cn_topic_0000001210206021_p84051254195315"></a>string</p> 567 </td> 568 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p104051454145312"><a name="zh-cn_topic_0000001210206021_p104051454145312"></a><a name="zh-cn_topic_0000001210206021_p104051454145312"></a>是</p> 569 </td> 570 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p11405145416535"><a name="zh-cn_topic_0000001210206021_p11405145416535"></a><a name="zh-cn_topic_0000001210206021_p11405145416535"></a>需要编码的格式。</p> 571 </td> 572 </tr> 573 </tbody> 574 </table> 575 576- 返回值： 577 578 <a name="zh-cn_topic_0000001210206021_table1040545414534"></a> 579 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row8405115495316"><th class="cellrowborder" valign="top" width="20.990000000000002%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p9405155418538"><a name="zh-cn_topic_0000001210206021_p9405155418538"></a><a name="zh-cn_topic_0000001210206021_p9405155418538"></a>类型</p> 580 </th> 581 <th class="cellrowborder" valign="top" width="79.01%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p164051954205320"><a name="zh-cn_topic_0000001210206021_p164051954205320"></a><a name="zh-cn_topic_0000001210206021_p164051954205320"></a>说明</p> 582 </th> 583 </tr> 584 </thead> 585 <tbody><tr id="zh-cn_topic_0000001210206021_row9406165415538"><td class="cellrowborder" valign="top" width="20.990000000000002%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p840675415537"><a name="zh-cn_topic_0000001210206021_p840675415537"></a><a name="zh-cn_topic_0000001210206021_p840675415537"></a>Uint8Array</p> 586 </td> 587 <td class="cellrowborder" valign="top" width="79.01%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p1640612547535"><a name="zh-cn_topic_0000001210206021_p1640612547535"></a><a name="zh-cn_topic_0000001210206021_p1640612547535"></a>返回编码后的文本。</p> 588 </td> 589 </tr> 590 </tbody> 591 </table> 592 593- 示例： 594 595 ``` 596 var textEncoder = new util.TextEncoder() 597 var result = new Uint8Array(buffer); 598 result = textEncoder.encode("\uD800¥¥"); 599 ``` 600 601 602### encodeInto<a name="zh-cn_topic_0000001210206021_section106591864813"></a> 603 604encodeInto\(input: string, dest: Uint8Array,\):\{ read: number; written: number \} 605 606放置生成的UTF-8编码文本。 607 608- 参数： 609 610 <a name="zh-cn_topic_0000001210206021_table19836147194911"></a> 611 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row28361472490"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001210206021_p783647164910"><a name="zh-cn_topic_0000001210206021_p783647164910"></a><a name="zh-cn_topic_0000001210206021_p783647164910"></a>参数名</p> 612 </th> 613 <th class="cellrowborder" valign="top" width="14.729999999999999%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001210206021_p148361478498"><a name="zh-cn_topic_0000001210206021_p148361478498"></a><a name="zh-cn_topic_0000001210206021_p148361478498"></a>类型</p> 614 </th> 615 <th class="cellrowborder" valign="top" width="9.16%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001210206021_p4836127194916"><a name="zh-cn_topic_0000001210206021_p4836127194916"></a><a name="zh-cn_topic_0000001210206021_p4836127194916"></a>必填</p> 616 </th> 617 <th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001210206021_p6837187154914"><a name="zh-cn_topic_0000001210206021_p6837187154914"></a><a name="zh-cn_topic_0000001210206021_p6837187154914"></a>说明</p> 618 </th> 619 </tr> 620 </thead> 621 <tbody><tr id="zh-cn_topic_0000001210206021_row383711716494"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p208373714498"><a name="zh-cn_topic_0000001210206021_p208373714498"></a><a name="zh-cn_topic_0000001210206021_p208373714498"></a>input</p> 622 </td> 623 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p5837147164919"><a name="zh-cn_topic_0000001210206021_p5837147164919"></a><a name="zh-cn_topic_0000001210206021_p5837147164919"></a>string</p> 624 </td> 625 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p1837127184919"><a name="zh-cn_topic_0000001210206021_p1837127184919"></a><a name="zh-cn_topic_0000001210206021_p1837127184919"></a>是</p> 626 </td> 627 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p5837571492"><a name="zh-cn_topic_0000001210206021_p5837571492"></a><a name="zh-cn_topic_0000001210206021_p5837571492"></a>需要编码的格式。</p> 628 </td> 629 </tr> 630 <tr id="zh-cn_topic_0000001210206021_row208371178497"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001210206021_p98372719499"><a name="zh-cn_topic_0000001210206021_p98372719499"></a><a name="zh-cn_topic_0000001210206021_p98372719499"></a>dest</p> 631 </td> 632 <td class="cellrowborder" valign="top" width="14.729999999999999%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001210206021_p1483715754912"><a name="zh-cn_topic_0000001210206021_p1483715754912"></a><a name="zh-cn_topic_0000001210206021_p1483715754912"></a>Uint8Array</p> 633 </td> 634 <td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001210206021_p38373712497"><a name="zh-cn_topic_0000001210206021_p38373712497"></a><a name="zh-cn_topic_0000001210206021_p38373712497"></a>是</p> 635 </td> 636 <td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001210206021_p13837107144913"><a name="zh-cn_topic_0000001210206021_p13837107144913"></a><a name="zh-cn_topic_0000001210206021_p13837107144913"></a>Uint8Array对象实例，用于将生成的UTF-8编码文本放入其中</p> 637 </td> 638 </tr> 639 </tbody> 640 </table> 641 642- 返回值： 643 644 <a name="zh-cn_topic_0000001210206021_table783787164915"></a> 645 <table><thead align="left"><tr id="zh-cn_topic_0000001210206021_row9837167174916"><th class="cellrowborder" valign="top" width="20.990000000000002%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001210206021_p11837972492"><a name="zh-cn_topic_0000001210206021_p11837972492"></a><a name="zh-cn_topic_0000001210206021_p11837972492"></a>类型</p> 646 </th> 647 <th class="cellrowborder" valign="top" width="79.01%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001210206021_p1283713716490"><a name="zh-cn_topic_0000001210206021_p1283713716490"></a><a name="zh-cn_topic_0000001210206021_p1283713716490"></a>说明</p> 648 </th> 649 </tr> 650 </thead> 651 <tbody><tr id="zh-cn_topic_0000001210206021_row1483717194915"><td class="cellrowborder" valign="top" width="20.990000000000002%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001210206021_p18379717495"><a name="zh-cn_topic_0000001210206021_p18379717495"></a><a name="zh-cn_topic_0000001210206021_p18379717495"></a>Uint8Array</p> 652 </td> 653 <td class="cellrowborder" valign="top" width="79.01%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001210206021_p18371071491"><a name="zh-cn_topic_0000001210206021_p18371071491"></a><a name="zh-cn_topic_0000001210206021_p18371071491"></a>返回编码后的文本。</p> 654 </td> 655 </tr> 656 </tbody> 657 </table> 658 659- 示例： 660 661 ``` 662 var that = new util.TextEncoder() 663 var buffer = new ArrayBuffer(4) 664 this.dest = new Uint8Array(buffer) 665 var result = that.encodeInto("abcd", this.dest) 666 ``` 667 668 669
