1# Arkts子系统变更说明 2 3## cl.arkts.1 TreeSet.clear()和TreeMap.clear()接口行为变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11容器类TreeMap和TreeSet的构造函数支持传入比较器，用户可以通过传入比较器来控制元素在二叉树上的插入位置。当用户调用了TreeMap和TreeSet的clear方法时，预期结果为仅清除数据， 12实际结果为清除数据的同时还清除了用户传入的比较器，导致再次插入数据时不会遵循用户传入的比较器的规则，而是按照默认比较器的规则，不符合用户预期，需要变更接口行为。 13 14**变更影响** 15 16不兼容变更，影响调用clear()后的排序规则。 17 18**变更前** 19 20- 情况一： 用户传入比较器，调用了TreeMap的clear方法后，比较器失效。 21 22``` 23//使用comparator firstValue > secondValue，表示为降序排序。 24let treeMap : TreeMap<string,string> = new TreeMap<string,string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 25treeMap.set("aa","3"); 26treeMap.set("dd","1"); 27treeMap.set("cc","2"); 28treeMap.set("bb","4"); 29let numbers = Array.from(treeMap.keys()) 30for (let item of numbers) { 31 console.log("treeMap:" + item); // key: dd cc bb aa 32} 33treeMap.clear(); 34treeMap.set("aa","3"); 35treeMap.set("dd","1"); 36treeMap.set("cc","2"); 37treeMap.set("bb","4"); 38numbers = Array.from(treeMap.keys()) 39for (let item of numbers) { 40 console.log("treeMap:" + item); //key: aa bb cc dd 41} 42``` 43 44- 情况二： 用户传入比较器，调用了TreeSet的clear方法后，比较器失效。 45 46``` 47let treeSet : TreeSet<string> = new TreeSet<string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 48treeSet.add("a"); 49treeSet.add("c"); 50treeSet.add("d"); 51treeSet.add("b"); 52let numbers = Array.from(treeSet.values()) 53for (let item of numbers) { 54 console.log("TreeSet:" + item); // value: d c b a 55} 56treeSet.clear(); 57treeSet.add("a"); 58treeSet.add("c"); 59treeSet.add("d"); 60treeSet.add("b"); 61numbers = Array.from(treeSet.values()) 62for (let item of numbers) { 63 console.log("TreeSet:" + item); // value: a b c d 64} 65``` 66**变更后** 67 68- 情况一： 用户传入比较器，调用了TreeMap的clear方法后，比较器正常排序。 69 70``` 71//使用comparator firstValue > secondValue，表示为降序排序。 72let treeMap : TreeMap<string,string> = new TreeMap<string,string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 73treeMap.set("aa","3"); 74treeMap.set("dd","1"); 75treeMap.set("cc","2"); 76treeMap.set("bb","4"); 77let numbers = Array.from(treeMap.keys()) 78for (let item of numbers) { 79 console.log("treeMap:" + item); // treeMap: dd cc bb aa 80} 81treeMap.clear(); 82treeMap.set("aa","3"); 83treeMap.set("dd","1"); 84treeMap.set("cc","2"); 85treeMap.set("bb","4"); 86numbers = Array.from(treeMap.keys()) 87for (let item of numbers) { 88 console.log("treeMap:" + item); // treeMap: dd cc bb aa 89} 90``` 91 92- 情况二： 用户传入比较器，调用了TreeSet的clear方法后，比较器正常排序。 93 94``` 95let treeSet : TreeSet<string> = new TreeSet<string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 96treeSet.add("a"); 97treeSet.add("c"); 98treeSet.add("d"); 99treeSet.add("b"); 100let numbers = Array.from(treeSet.values()) 101for (let item of numbers) { 102 console.log("TreeSet:" + item); // TreeSet: d c b a 103} 104treeSet.clear(); 105treeSet.add("a"); 106treeSet.add("c"); 107treeSet.add("d"); 108treeSet.add("b"); 109numbers = Array.from(treeSet.values()) 110for (let item of numbers) { 111 console.log("TreeSet:" + item); // TreeSet: d c b a 112} 113``` 114**起始API Level** 115 1168 117 118**变更发生版本** 119 120从OpenHarmony SDK 5.0.0.32 版本开始。 121 122**变更的接口/组件** 123 124TreeMap.clear(); 125TreeSet.clear(); 126 127**适配指导** 128 129TreeSet.clear()和TreeMap.clear()方法行为变更之后，用户无需重新设置比较器也能正常排序，也可以重新设置比较器来改变元素的排序方式。 130 131文档可参考如下： 132 133[TreeMap.clear()](../../../application-dev/reference/apis-arkts/js-apis-treemap.md#clear) 134 135[TreeSet.clear()](../../../application-dev/reference/apis-arkts/js-apis-treeset.md#clear) 136 137## cl.arkts.2 TreeMap.setAll()接口行为变更 138 139**访问级别** 140 141公开接口 142 143**变更原因** 144 145使用setAll接口添加一个空的TreeMap，预期长度+0，实际长度+1。 146 147**变更影响** 148 149该变更为不兼容性变更，影响调用TreeMap.setAll()后TreeMap的长度。 150 151- **变更前** 使用setAll接口添加treeMap1后treeMap长度为1 152 153``` 154let treeMap : TreeMap<string, number> = new TreeMap(); 155let treeMap1 : TreeMap<string, number> = new TreeMap(); 156treeMap.setAll(treeMap1); // 将treeMap1中的所有元素添加到treeMap中 157console.info("length:", treeMap.length) // length:1 158``` 159 160- **变更后** 使用setAll接口添加treeMap1后treeMap长度为0 161 162``` 163let treeMap : TreeMap<string, number> = new TreeMap(); 164let treeMap1 : TreeMap<string, number> = new TreeMap(); 165treeMap.setAll(treeMap1); // 将treeMap1中的所有元素添加到treeMap中 166console.info("length:",treeMap.length) // length:0 167``` 168 169**起始API Level** 170 1718 172 173**变更发生版本** 174 175从OpenHarmony SDK 5.0.0.32 版本开始。 176 177**变更的接口/组件** 178 179TreeMap.setAll(); 180 181**适配指导** 182 183对于TreeMap.setAll()传入空TreeMap的情况，开发者需要针对变更前后TreeMap的长度变化进行适配。 184 185文档可参考如下： 186 187[TreeMap.setAll()](../../../application-dev/reference/apis-arkts/js-apis-treemap.md#setall) 188 189## cl.arkts.3 TreeMap、TreeSet的hasKey和has接口行为变更 190 191**访问级别** 192 193公开接口 194 195**变更原因** 196 1971. 对于传入用户自定义比较器的TreeMap， 不能正确区分undefined或null与其他元素的比较关系，导致在没有插入null或undefined的情况下hasKey(null/undefined)错误返回true。 1982. 对于传入用户自定义比较器的TreeSet， 不能正确区分undefined或null与其他元素的比较关系，导致在没有插入null或undefined的情况下has(null/undefined)错误返回true。 199 200**变更影响** 201 202不兼容变更，影响TreeMap.hasKey()、TreeSet.has()传入undefined或null时的返回值。 203 204- **变更前** 205 206- 情况一： 对于传入用户自定义比较器的TreeMap，在没有插入null或undefined的情况下hasKey(null/undefined)错误返回true。 207 208``` 209let treeMap : TreeMap<string, number> = new TreeMap((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 210treeMap.set("aa",3); 211treeMap.set("dd",1); 212let res = treeMap.hasKey(null); 213let res1 = treeMap.hasKey(undefined); 214console.info("res:", res) // res:true 215console.info("res1:",res1) // res1:true 216``` 217 218- 情况二： 对于传入用户自定义比较器的TreeSet，在没有插入null或undefined的情况下has(null/undefined)错误返回true。 219 220``` 221let treeSet : TreeSet<string> = new TreeSet<string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 222treeSet.add("a"); 223treeSet.add("c"); 224let res = treeSet.has(null); 225let res1 = treeSet.has(undefined); 226console.info("res:", res) // res:true 227console.info("res1:",res1) // res1:true 228``` 229 230- **变更后** 231 232- 情况一： 对于传入用户自定义比较器的TreeMap，在没有插入null或undefined的情况下hasKey(null/undefined)返回fasle。 233 234``` 235let treeMap : TreeMap<string, number> = new TreeMap((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 236treeMap.set("aa",3); 237treeMap.set("dd",1); 238let res = treeMap.hasKey(null); 239let res1 = treeMap.hasKey(undefined); 240console.info("res:", res) // res:false 241console.info("res1:",res1) // res1:false 242``` 243 244- 情况二： 对于传入用户自定义比较器的TreeSet，在没有插入null或undefined的情况下has(null/undefined)返回false。 245 246``` 247let treeSet : TreeSet<string> = new TreeSet<string>((firstValue: string, secondValue: string) : boolean => {return firstValue > secondValue}); 248treeSet.add("a"); 249treeSet.add("c"); 250let res = treeSet.has(null); 251let res1 = treeSet.has(undefined); 252console.info("res:", res) // res:false 253console.info("res1:",res1) // res1:false 254``` 255 256 257**起始API Level** 258 2598 260 261**变更发生版本** 262 263从OpenHarmony SDK 5.0.0.32 版本开始。 264 265**变更的接口/组件** 266 267TreeMap.hasKey(); 268TreeSet.has(); 269 270**适配指导** 271 272对于TreeMap.hasKey()、TreeSet.has()接口传入null或undefined的情况。开发者需要针对变更前后返回值的变化进行适配。 273 274文档可参考如下： 275 276[TreeMap.hasKey()](../../../application-dev/reference/apis-arkts/js-apis-treemap.md#haskey) 277 278[TreeSet.has()](../../../application-dev/reference/apis-arkts/js-apis-treeset.md#has) 279 280 281## cl.arkts.4 URLParams类append接口添加的值中包含连续空格时行为变更 282 283**访问级别** 284 285公开接口 286 287**变更原因** 288 289URLParams类append接口添加的字符串中包含连续多个空格时，连续空格会被错误处理成只转换为一个'+'，该实现不符合URL的标准。 290 291 **变更影响** 292 293不兼容变更，影响URLParams.append()接口在入参包含连续空格时的处理结果。 294 295**起始 API Level** 296 2979 298 299**变更发生版本** 300 301从OpenHarmony SDK 5.0.0.32开始。 302 303**变更的接口/组件** 304 305URLParams对象的append接口。 306 307变更前：URLParams对象使用append()方法添加键值对时，若添加的字符串中存在连续多个空格时，接口表现为将连续多个空格只转换为一个'+'。 308```ts 309{ 310 const objectParams = new url.URLParams("key=abc") 311 console.log(objectParams.toString()) // "key=abc" 312 objectParams.append('key1', 'd e f'); 313 console.log(objectParams.toString()) // "key=abc&key1=d+e+f" 314} 315``` 316 317变更后：URLParams对象使用append()方法添加键值对时，若添加的字符串中存在连续多个空格时，接口表现为将连续多个空格转换为对应空格数量的'+'。 318```ts 319{ 320 const objectParams = new url.URLParams("key=abc") 321 console.log(objectParams.toString()) // "key=abc" 322 objectParams.append('key1', 'd e f'); 323 console.log(objectParams.toString()) // "key=abc&key1=d+++e+++f" 324} 325``` 326 327**适配指导** 328 329开发者在涉及上面append的使用场景时，在变更生效前如果对append添加的键值对做后续处理操作，变更后需针对表现不同做针对性适配。 330 331## cl.arkts.5 URLParams类在入参字符串中包含大小写不同编码值时，toString()接口表现结果不一致变更 332 333**访问级别** 334 335公开接口 336 337**变更原因** 338 339URLParams类在入参字符串中包含大小写不同编码值时toString()接口返回值有误，主要涉及："%2b"和"%2B"的表现不一致，"%2B"被处理为"%2B"是符合标准的，但"%2b"会被错误处理成'+'。 340 341 **变更影响** 342 343不兼容变更，影响当URLParams构造函数入参字符串中存在"%2b"时URLParams.toString()的返回结果。 344 345**起始 API Level** 346 3479 348 349**变更发生版本** 350 351从OpenHarmony SDK 5.0.0.32开始。 352 353**变更的接口/组件** 354 355URL模块URLParams类toString接口， 356 357变更前：创建URLParams对象，如果入参字符串中存在"%2b"和"%2B"时，在toString()后返回的字符串分别表现为"+"和"%2B"。 358```ts 359{ 360 const objectParams = new url.URLParams("key%2b=abc%2B") 361 console.log(objectParams.toString()) // "key+=abc%2B" 362} 363``` 364 365变更后：创建URLParams对象，如果入参字符串中存在"%2b"和"%2B"时，在toString()后返回的字符串均表现为"%2B"; 366```ts 367{ 368 const objectParams = new url.URLParams("key%2b=abc%2B") 369 console.log(objectParams.toString()) // "key%2B=abc%2B" 370} 371``` 372 373**适配指导** 374 375开发者在涉及上述使用场景时，在变更生效前如果对toString()返回值做后续处理操作，变更后需针对表现不同做针对性适配。 376 377## cl.arkts.6 URLParams类append接口行为变更 378 379**访问级别** 380 381公开接口 382 383**变更原因** 384 385URLParams使用append()方法时，对入参键值对中的特殊字符会错误进行encode，该行为与URL标准不一致，导致后续对键值对进行增删改查等操作出现异常。 386 387 **变更影响** 388 389不兼容变更，影响当URLParams.append()入参包含中文等特殊字符时该函数的处理结果。 390 391**起始 API Level** 392 3939 394 395**变更发生版本** 396 397从OpenHarmony SDK 5.0.0.32开始。 398 399**变更的接口/组件** 400 401URLParams类append接口。 402 403变更前：URLParams使用append()方法添加键值对, 若想通过添加的key使用get、has、delete、set接口进行增删改查操作，需先对key进行额外encode。 404```ts 405{ 406 const objectParams = new url.URLParams('?fod=1&bard=2') 407 objectParams.append("key&大", "abc"); 408 objectParams.has('key&大'); // false 409 objectParams.has('%E5%A4%A7'); // true 410 objectParams.get('key&大'); // undefined 411 objectParams.get('%E5%A4%A7'); // abc 412} 413``` 414 415变更后: URLParams使用append()方法添加键值对,可直接使用添加的key拿到对应value进行增删改查操作。 416```ts 417{ 418 const objectParams = new url.URLParams('?fod=1&bard=2') 419 objectParams.append("key&大", "abc"); 420 objectParams.has('key&大'); // true 421 objectParams.has('%E5%A4%A7'); // false 422 objectParams.get('key&大'); // abc 423 objectParams.get('%E5%A4%A7'); // undefined 424} 425``` 426 427**适配指导** 428 429对于URLParams.append()入参包含中文等特殊字符的情况。开发者需要针对变更前后调用has()、get()、delete()、set()传入这些字符时处理结果及返回值的变化进行适配。