clearVar

App VarをLucyStudioで宣言したときに指定した初期値にリセットします。

Parameters

• appVarName (string): LucyStudioアプリ設定で事前定義された変数名

Returns

なし（void）

Description

$app.clearVarは指定したApp Varをnullにするのではなく、LucyStudioデザイナーで変数を宣言したときに設定したデフォルト値（初期値）に復元します。内部ではLucyVarMngr.clearVarValue(appVarMap, appVarName)を呼び出します。

アプリ全体の変数なので、あるフォームでclearVarを呼び出すと、ほかのフォームでもリセットされた値が読み取られます。

⚠️ clearVar後の値はnullではなく、LucyStudioで定義したデフォルト値です。リセット後はgetVarで実際の値を確認してください。

$app vs $form vs $pageの比較

区分	$app.clearVar	$form.clearVar
スコープ	アプリ全体で共有	現在のフォームインスタンス
リセットの基準	LucyStudioアプリで宣言したデフォルト値	LucyStudioフォームで宣言したデフォルト値
ライフサイクル	アプリ実行中は保持	フォームが閉じると破棄
他のフォームへの影響	✅ すべてのフォームに反映	❌ そのフォームのみ

Example

// App VarをLucyStudioで宣言した初期値に復元
$app.clearVar("loginUserId");
var restored = $app.getVar("loginUserId");
$log.i("초기화 후 userId:", restored); // LucyStudioで宣言したデフォルト値を出力

// ログアウト時に複数のApp Varをリセット
$app.clearVar("loginUserId");
$app.clearVar("theme");
$app.clearVar("cartItems");

Related

• $app.setVar(appVarName, data) — App Varの設定
• $app.getVar(appVarName) — App Varの読み取り
• $form.clearVar(localVarName) — フォーム単位の変数のリセット（そのフォーム内でのみ有効）