YouTrack および Hub ヘルプの開発者ポータル

Set

`Set` オブジェクトは、プリミティブな値であろうとオブジェクト参照であろうと、あらゆるタイプの一意の値を格納します。Set は、この API のすべての複数値オブジェクトの格納場所として使用されます。複数の値を格納するカスタムフィールド、リンクの発行、プロジェクト内の発行などです。コレクション内の単一の値に直接アクセスするか（first()、last()、get(index) を参照）、反復子を使用する（entries()、values() を参照）、forEach(visitor) メソッドを使用して検索（述語）することができます。ワークフロー API は ECMAScript 5.1 に基づいています。この Set 実装は ES 6 セットインターフェースでサポートされている機能を模倣しています。

Properties

名前

タイプ

説明

added

設定

現在のトランザクションの複数の値を格納するフィールドに追加される要素。Set が永続エンティティの複数値プロパティ（フィールド）を表す場合にのみ関連します。

isChanged

boolean

Set が永続エンティティの複数値プロパティ（フィールド）を表し、現在のトランザクションでフィールドが変更されると、このプロパティは「true」になります。

removed

設定

現在のトランザクションで複数の値を格納するフィールドから削除される要素。Set が永続エンティティの複数値プロパティ（フィールド）を表す場合にのみ関連します。

size

数

セット内の要素の数。大規模なコレクション（「project.issues」など）の計算はリソースを消費する可能性があるため、慎重に使用してください。

メソッド

add

add(element)

セットに要素を追加します。指定された値がすでに存在する場合、重複する値は追加されません。

パラメーター

名前

タイプ

説明

element

オブジェクト

セットに追加する要素。

clear

clear()

セットからすべての値を削除します。

delete

delete(element)

セットから要素を削除します。指定された要素が存在しない場合、何も起こりません。

パラメーター

名前

タイプ

説明

element

オブジェクト

セットから削除する要素。

entries

entries()

Set のエントリの反復子を取得します。` values() ` と同じ。特定の条件が満たされるまでエントリを走査し、同時にエントリを変更する必要がある場合は、イテレータを使用します。

戻り値

タイプ

説明

Iterator.<Object>

値のコレクションのイテレータ。

サンプル

// We want to find first Critical among issue subtasks and assign it. const checkAndAssign = function(task) { if (task.fields.Priority.name === ctx.Priority.Critical.name) { task.fields.Assignee = ctx.currentUser; return true; } return false; }; const iter = issue.links['parent for'].entries(); let v = iter.next(); while (!v.done && !checkAndAssign(v.value)) { v = iter.next(); }

関連事項

  • セット内のすべての要素を変更する必要がある場合は、forEach(visitor) を参照してください。

  • 特定の基準を満たす要素を見つける必要がある場合は、find(predicate) を参照してください。

find

find(predicate)

述語関数が「true」を返すセット内の最初の要素を見つけます。

パラメーター

名前

タイプ

説明

predicate

関数

Set の特定の値に対して true または false を返す引数を 1 つ持つ関数。

戻り値

タイプ

説明

Object

述語関数または undefined に対して `true` を返す最初の値。

サンプル

issue.tags.find(function(tag) { return tag.name === 'release'; });

first

first()

要素がセットに追加された順序に基づいて、コレクション内の最初のオブジェクトを見つけます。

戻り値

タイプ

説明

Object

コレクションの最初のオブジェクト、またはコレクションが空の場合は null。

forEach

forEach(visitor)

コレクションの各メンバーにビジター関数を適用します。

パラメーター

名前

タイプ

説明

visitor

関数

コレクションの各メンバーに適用される関数。

サンプル

issue.links['parent for'].forEach(function(child) { child.fields.Priority = issue.fields.Priority; });

get

get(index)

セット内の特定のインデックス位置を持つ要素を見つけます。

パラメーター

名前

タイプ

説明

index

数

Set から返される要素の序数インデックス。

戻り値

タイプ

説明

Object

セット内のインデックス位置にあるオブジェクト、またはセットに含まれる要素が（インデックス + 1）より少ない場合は null。

has

has(element)

Set オブジェクトをチェックして、指定した要素がコレクションに存在するかどうかを判断します。

パラメーター

名前

タイプ

説明

element

オブジェクト

セット内で検索する要素。

戻り値

タイプ

説明

boolean

要素が見つかった場合は「true」、そうでない場合は「false」を返します。

isEmpty

isEmpty()

Set オブジェクトをチェックして、空かどうかを判断します。

戻り値

タイプ

説明

boolean

セットが空の場合は「true」を返し、そうでない場合は「false」を返します。

isNotEmpty

isNotEmpty()

Set オブジェクトをチェックして、空でないかどうかを判断します。

戻り値

タイプ

説明

boolean

セットが空でない場合は「true」を返し、そうでない場合は「false」を返します。

last

last()

要素がセットに追加された順序に基づいて、コレクション内の最後のオブジェクトを見つけます。

戻り値

タイプ

説明

Object

コレクションの最後のオブジェクト。コレクションが空の場合は null。

values

values()

Set のエントリの反復子を取得します。` entries() ` と同じ。

戻り値

タイプ

説明

Iterator.<Object>

値のコレクションのイテレータ。

関連事項

  • 詳細については、entries() を参照してください。

SavedQuerySimpleCalendar