clearVar

앱 변수를 LucyStudio에서 선언 시 지정한 초기값으로 초기화합니다.

Parameters

• appVarName (string): LucyStudio 앱 설정에서 사전 정의된 변수명

Returns

없음 (void)

Description

$app.clearVar는 지정된 앱 변수를 null로 초기화하는 것이 아니라, LucyStudio 디자이너에서 변수 선언 시 설정한 기본값(초기값)으로 복원합니다. 내부적으로 LucyVarMngr.clearVarValue(appVarMap, appVarName)를 호출합니다.

앱 전역 변수이므로, 한 폼에서 clearVar를 호출하면 다른 폼에서도 초기화된 값을 읽게 됩니다.

⚠️ clearVar 후의 값은 null이 아닌 LucyStudio에서 정의한 기본값입니다. 초기화 후 getVar로 실제 값을 확인하세요.

$app vs $form vs $page 비교

구분	$app.clearVar	$form.clearVar
스코프	앱 전역 공유	현재 폼 인스턴스
초기화 기준	LucyStudio 앱에서 선언한 기본값	LucyStudio 폼에서 선언한 기본값
생명주기	앱 실행 중 유지	폼이 닫히면 소멸
다른 폼에서 영향	✅ 모든 폼에 반영	❌ 해당 폼에만

Example

// 앱 변수를 LucyStudio에서 선언한 초기값으로 복원
$app.clearVar("loginUserId");
var restored = $app.getVar("loginUserId");
$log.i("초기화 후 userId:", restored); // LucyStudio에서 선언한 기본값 출력

// 로그아웃 시 여러 앱 변수 초기화
$app.clearVar("loginUserId");
$app.clearVar("theme");
$app.clearVar("cartItems");

Related

• $app.setVar(appVarName, data) — 앱 변수 설정
• $app.getVar(appVarName) — 앱 변수 읽기
• $form.clearVar(localVarName) — 폼 단위 변수 초기화 (해당 폼에서만 유효)