TestFX技术问题：如何测试JavaFX按钮点击后打开新窗口（IntelliJ环境）

我之前也踩过这个坑，直接拿主Stage肯定不对——新窗口是完全独立的Stage实例，TestFX其实有专门的API来处理这种场景，给你几个实用的解决方法：

1. 先做好测试类的基础准备 #

首先得确保你的测试类正确继承TestFX的基类，不同版本的写法略有区别：

• TestFX 3.x及以下：继承ApplicationTest
• TestFX 4.x+：可以继承FxRobotTest，或者直接注入FxRobot对象

举个基础的测试类示例：

// TestFX 5.x 版本示例
import org.junit.jupiter.api.Test;
import org.testfx.framework.junit5.ApplicationTest;
import javafx.stage.Stage;
import java.time.Duration;
import static org.testfx.assertions.api.Assertions.assertThat;
import static org.testfx.matcher.base.WindowMatchers.withTitle;

public class NewWindowTest extends ApplicationTest {

    @Override
    public void start(Stage stage) throws Exception {
        // 初始化你的主应用界面
        MainApp mainApp = new MainApp();
        mainApp.start(stage);
    }

    @Test
    void testOpenNewWindowButton() {
        // 点击打开新窗口的按钮（假设按钮的fx:id是openNewWindowBtn）
        clickOn("#openNewWindowBtn");

        // 方法1：通过窗口标题验证新窗口已打开
        assertThat(window(withTitle("我的新窗口"))).isNotNull();

        // 方法2：通过新窗口内的专属组件验证（比如新窗口里有个fx:id为newWindowContent的Label）
        assertThat(lookup("#newWindowContent").queryLabeled()).isNotNull();

        // 如果窗口加载有延迟，用waitUntil等待窗口出现，避免时序问题
        waitUntil(() -> window(withTitle("我的新窗口")) != null, Duration.seconds(2));
    }
}

2. 核心注意事项 #

• 别再盯着主Stage了：新窗口是独立的Stage实例，TestFX的window()方法会自动扫描当前所有打开的JavaFX窗口，直接用这个方法定位就行
• 优先用唯一特征定位：窗口标题、内部组件的fx:id都是比直接找Stage实例更可靠的定位依据
• 处理异步加载：如果新窗口需要异步初始化内容，一定要用waitUntil()或者await()方法等待，避免测试因为加载延迟失败

3. 额外小技巧：测试后清理新窗口（可选） #

如果测试完成后需要关闭新窗口做环境清理，可以直接调用窗口的关闭方法：

Window newWindow = window(withTitle("我的新窗口"));
((Stage) newWindow).close();

内容的提问来源于stack exchange，提问作者Harry