/* Copyright (C) 2026 Wildfire Games. * This file is part of 0 A.D. * * 0 A.D. is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 2 of the License, or * (at your option) any later version. * * 0 A.D. is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with 0 A.D. If not, see . */ #include "lib/self_test.h" #include "gui/GUIManager.h" #include "gui/CGUI.h" #include "lib/external_libraries/libsdl.h" #include "lib/file/file_system.h" #include "lib/file/vfs/vfs.h" #include "lib/input.h" #include "lib/path.h" #include "ps/CLogger.h" #include "ps/CStr.h" #include "ps/ConfigDB.h" #include "ps/Filesystem.h" #include "ps/GameSetup/GameSetup.h" #include "ps/Hotkey.h" #include "ps/XML/Xeromyces.h" #include "scriptinterface/FunctionWrapper.h" #include "scriptinterface/Object.h" #include "scriptinterface/ScriptConversions.h" #include "scriptinterface/ScriptInterface.h" #include "scriptinterface/ScriptRequest.h" #include "scriptinterface/StructuredClone.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include "js/Promise.h" class TestGuiManager : public CxxTest::TestSuite { std::unique_ptr configDB; std::optional xeromycesEngine; std::optional scriptInterface; public: void setUp() { g_VFS = CreateVfs(); TS_ASSERT_OK(g_VFS->Mount(L"", DataDir() / "mods" / "_test.gui" / "", VFS_MOUNT_MUST_EXIST)); TS_ASSERT_OK(g_VFS->Mount(L"cache", DataDir() / "_testcache" / "", 0, VFS_MAX_PRIORITY)); configDB = std::make_unique(); xeromycesEngine.emplace(); scriptInterface.emplace("Engine", "GUIManager", *g_ScriptContext); g_GUI = new CGUIManager{*g_ScriptContext, *scriptInterface}; } void tearDown() { delete g_GUI; scriptInterface.reset(); xeromycesEngine.reset(); configDB.reset(); g_VFS.reset(); DeleteDirectory(DataDir()/"_testcache"); } void test_EventObject() { // Load up a test page. ScriptRequest rq{g_GUI->GetScriptInterface()}; JS::RootedValue val(rq.cx); Script::CreateObject(rq, &val); Script::StructuredClone data = Script::WriteStructuredClone(rq, JS::NullHandleValue); g_GUI->OpenChildPage(L"event/page_event.xml", data); const ScriptInterface& pageScriptInterface = *(g_GUI->GetActiveGUI()->GetScriptInterface()); ScriptRequest prq(pageScriptInterface); JS::RootedValue global(prq.cx, prq.globalValue()); int called_value = 0; JS::RootedValue js_called_value(prq.cx); // Ticking will call the onTick handlers of all object. The second // onTick is configured to disable the onTick handlers of the first and // third and enable the fourth. So ticking once will only call the // first and second object. We don't want the fourth object to be // called, to avoid infinite additions of objects. g_GUI->TickObjects(); Script::GetProperty(prq, global, "called1", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 1); Script::GetProperty(prq, global, "called2", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 1); Script::GetProperty(prq, global, "called3", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 0); Script::GetProperty(prq, global, "called4", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 0); // Ticking again will still call the second object, but also the fourth. g_GUI->TickObjects(); Script::GetProperty(prq, global, "called1", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 1); Script::GetProperty(prq, global, "called2", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 2); Script::GetProperty(prq, global, "called3", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 0); Script::GetProperty(prq, global, "called4", &js_called_value); Script::FromJSVal(prq, js_called_value, called_value); TS_ASSERT_EQUALS(called_value, 1); } void test_hotkeysState() { // Load up a fake test hotkey when pressing 'a'. const char* test_hotkey_name = "hotkey.test"; configDB->SetValueString(CFG_SYSTEM, test_hotkey_name, "A"); LoadHotkeys(*configDB); // Load up a test page. ScriptRequest rq{g_GUI->GetScriptInterface()}; JS::RootedValue val(rq.cx); Script::CreateObject(rq, &val); Script::StructuredClone data = Script::WriteStructuredClone(rq, JS::NullHandleValue); g_GUI->OpenChildPage(L"hotkey/page_hotkey.xml", data); // Press 'a'. SDL_Event_ hotkeyNotification; hotkeyNotification.ev.type = SDL_KEYDOWN; hotkeyNotification.ev.key.keysym.scancode = SDL_SCANCODE_A; hotkeyNotification.ev.key.repeat = 0; // Init input and poll the event. InitInput(); in_push_priority_event(&hotkeyNotification); SDL_Event_ ev; while (in_poll_event(&ev)) in_dispatch_event(&ev); const ScriptInterface& pageScriptInterface = *(g_GUI->GetActiveGUI()->GetScriptInterface()); ScriptRequest prq(pageScriptInterface); JS::RootedValue global(prq.cx, prq.globalValue()); // Ensure that our hotkey state was synchronised with the event itself. bool hotkey_pressed_value = false; JS::RootedValue js_hotkey_pressed_value(prq.cx); Script::GetProperty(prq, global, "state_before", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, true); hotkey_pressed_value = false; Script::GetProperty(prq, global, "state_after", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, true); // We are listening to KeyDown events, so repeat shouldn't matter. hotkeyNotification.ev.key.repeat = 1; in_push_priority_event(&hotkeyNotification); while (in_poll_event(&ev)) in_dispatch_event(&ev); hotkey_pressed_value = false; Script::GetProperty(prq, global, "state_before", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, true); hotkey_pressed_value = false; Script::GetProperty(prq, global, "state_after", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, true); hotkeyNotification.ev.type = SDL_KEYUP; in_push_priority_event(&hotkeyNotification); while (in_poll_event(&ev)) in_dispatch_event(&ev); hotkey_pressed_value = true; Script::GetProperty(prq, global, "state_before", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, false); hotkey_pressed_value = true; Script::GetProperty(prq, global, "state_after", &js_hotkey_pressed_value); Script::FromJSVal(prq, js_hotkey_pressed_value, hotkey_pressed_value); TS_ASSERT_EQUALS(hotkey_pressed_value, false); UnloadHotkeys(); } static void CloseTopmostPage() { ScriptRequest rq{g_GUI->GetActiveGUI()->GetScriptInterface()}; JS::RootedValue global{rq.cx, rq.globalValue()}; TS_ASSERT(ScriptFunction::CallVoid(rq, global, "closePageCallback")); // Check whether promises are settled in the page stack and flush the stack. g_GUI->TickObjects(); } void test_PageRegainedFocusEvent() { ScriptRequest rq{g_GUI->GetScriptInterface()}; const Script::StructuredClone undefined{ Script::WriteStructuredClone(rq, JS::UndefinedHandleValue)}; TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 0); g_GUI->OpenChildPage(L"regainFocus/page_emptyPage.xml", undefined); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 1); // This page instantly pushes an empty page with a callback that pops another page again. g_GUI->OpenChildPage(L"regainFocus/page_pushWithPopOnInit.xml", undefined); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 3); // Pop the empty page and execute the continuation. CloseTopmostPage(); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 1); CloseTopmostPage(); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 0); } void test_ResolveReject() { TestLogger logger; constexpr std::array, 2> testSteps{{ {false, JS::PromiseState::Fulfilled}, {true, JS::PromiseState::Rejected}}}; const ScriptRequest rq{g_GUI->GetScriptInterface()}; const Script::StructuredClone undefined{ Script::WriteStructuredClone(rq, JS::UndefinedHandleValue)}; g_GUI->OpenChildPage(L"regainFocus/page_emptyPage.xml", undefined); for (const auto& [reject, result] : testSteps) { const JS::RootedValue value{rq.cx, JS::BooleanValue(reject)}; const Script::StructuredClone clonedValue{Script::WriteStructuredClone(rq, value)}; const JS::RootedValue promise{rq.cx, g_GUI->OpenChildPage(L"resolveReject/page_resolveReject.xml", clonedValue)}; // Check whether promises are settled in the page stack and flush the stack. g_GUI->TickObjects(); const JS::RootedObject promiseObject{rq.cx, &promise.toObject()}; TS_ASSERT_EQUALS(JS::GetPromiseState(promiseObject), result); } } void test_Sequential() { const ScriptRequest rq{g_GUI->GetScriptInterface()}; const Script::StructuredClone undefined{ Script::WriteStructuredClone(rq, JS::UndefinedHandleValue)}; g_GUI->OpenChildPage(L"sequential/page_sequential.xml", undefined); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 2); CloseTopmostPage(); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 2); CloseTopmostPage(); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 0); } void test_Result() { const ScriptRequest rq{g_GUI->GetScriptInterface()}; g_GUI->OpenChildPage(L"Result/page_Result.xml", Script::WriteStructuredClone(rq, JS::FalseHandleValue)); TS_ASSERT(!g_GUI->TickObjects().value()); g_GUI->OpenChildPage(L"Result/page_Result.xml", Script::WriteStructuredClone(rq, JS::TrueHandleValue)); TS_ASSERT(g_GUI->TickObjects().value()); } void test_MultipleRootModules() { ScriptRequest rq{g_GUI->GetScriptInterface()}; TS_ASSERT_THROWS_EQUALS(g_GUI->OpenChildPage( L"multiple_root-modules/page.xml", Script::WriteStructuredClone(rq, JS::NullHandleValue)), const std::logic_error& e, e.what(), "There can only be one root module per page."); } void test_Await() { ScriptRequest rq{g_GUI->GetScriptInterface()}; TS_ASSERT_THROWS(g_GUI->OpenChildPage(L"await/page.xml", Script::WriteStructuredClone(rq, JS::NullHandleValue)), const std::bad_variant_access&); } void test_OpenRequest() { const ScriptRequest rq{g_GUI->GetScriptInterface()}; g_GUI->OpenChildPage(L"OpenRequest/Root/Page.xml", Script::WriteStructuredClone(rq, JS::UndefinedHandleValue)); TS_ASSERT_EQUALS(g_GUI->GetPageCount(), 2); g_GUI->TickObjects(); const ScriptRequest pageRq{g_GUI->GetActiveGUI()->GetScriptInterface()}; JS::RootedValue global{pageRq.cx, pageRq.globalValue()}; std::string result; TS_ASSERT(ScriptFunction::Call(pageRq, global, "closePageCallback", result)); TS_ASSERT_STR_EQUALS(result, "Entry Continuation"); } };