リリースノート｜バージョン 1.7

主要パッケージ (@yamato-daiwa/es-extensions)

破壊的変更

配列の弄り

getArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOneと getIndexOfArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOneでのの３引数目の名前変更

オブジェクト型の第３引数目に於いて、 mustThrowErrorIfElementNotFoundOrMoreThan1プロパティは mustThrowErrorIfElementNotFoundOrMatchesAreMultipleに名前が変更された。

理由

以前の名前が迷わせる、即ち「or more than1」を「元の配列に１個以上の要素がなくては 成らない」と勘違いしがち。 今の「or matches are multiple」（「・・・それとも一致は複数の場合」）は、 プレディケートに満たされている要素の中には複数がなくては成らないと明確に伝える様に成った。

貴方のコードが編集が必要に成る条件

getArrayElementSatisfiesThePredicateIfSuchElementIsExactlyOneの利用の際、 ３引数目が参照されている所が有る。

対策

コードエディター又は結合開発環境の適切な機能を使って、プロジェクトの全ファイルに mustThrowErrorIfElementNotFoundOrMoreThan1を mustThrowErrorIfElementNotFoundOrMatchesAreMultipleに置き換えて下さい。

「RawObjectDataProcessor」クラス

ローカリゼーションオブジェクト名前変更

更新された名付けのガイドライン通り、RawObjectDataProcessorLocalization__Englishと言う ローカリゼーションオブジェクトはrawObjectDataProcessorLocalization__englishに 名前が変更された。 同じ様な変更が他のローカリゼーションオブジェクトにも適応された。

ブラウザーJavaScript (@yamato-daiwa/es-extensions-browserjs)

破壊的変更

DOMの弄り

getExpectedToBeSingleDOM_ElementとgetExpectedToBeSingleChildOfTemplateElement関数に於ける 引数及びエラー投擲条件変更

以前、オブジェクト型の単一引数は# [+ImportantEntity__Code--YDID context]と言う多態性の任意 プロパティが有り、指定された場合、 Element型か、 Document型か、 これらから継承した型でなければいけなかった。 当プロパティはcontextElementに代わり、多態性の儘だが、 型はParentNode | Readonly<{ selector: string; }>に成った御蔭て コンテキスト要素自体だけでなく、此れのセレクターを指定可能に成った。 但し、コンテキスト要素のセレクターが指定してある場合、此れに丁度 一個の要素が該当しなければいけない、然もないと エラーが投げられる（0個の場合は DOM_ElementRetrievingFailedError、２個以上の場合 UnexpectedEventError）。 [+ImportantEntity__Code--YDID Element]もDocumentも ParentNodeから継承した御蔭で、旧いプロパティの型と 新しいプロパティの型が互換性が有る。

理由

コンテキスト要素の指定方法の統一。 ParentNode | Readonly<{ selector: string; }>型の contextElementプロパティは複数の関数に使われる様に成った だけでなく、YDEE以外にも使われる事がある（例えば、Yamato Daiwa Frontendと言うフロントエンド開発専用ライブラリ.

貴方のコードが編集が必要に成る条件

getExpectedToBeSingleDOM_Element関数か、 getExpectedToBeSingleChildOfTemplateElement関数の プロパティが使用中。

対策

コードエディター又は結合開発環境の適切な機能を使って、プロジェクトの全ファイルに contextプロパティをcontextElementに 置き換えて下さい。 コンテキスト要素ではなく、此れのセレクターが使えれば便利なら、最新のAPIを 使ってリファクタリングしても良いが、エラーが投げられない様に、セレクターに丁度 1個の要素が該当している様に気を付けるのだ。