java.lang.Object
- org.testfx.api.FxToolkit

```
public final class FxToolkit
extends Object
```
Responsible for setup and cleanup of JavaFX fixtures that need the JavaFX thread.

Overview

This class methods cover three different kinds of fixtures:
1. Container fixtures, which are registered as registeredStage.
2. Content fixtures, which are attached to the registered registeredStage.
3. Individual fixtures, which do not require a registeredStage.
Additionally it keeps an internal context.

1. Container Fixtures

They can be registered as registeredStage and provide a top-level container, i.e. Stages.
The primary stage can be registered as registeredStage using registerPrimaryStage(). This call is mandatory before any other JavaFX fixture can be created.
Other stages can be registered as registeredStage using registerStage(Supplier<Stage>).

2. Content Fixtures

They can be attached to the registeredStage.
Either constructed by calling an Application.start(), by supplying Scenes, Parents, or by consuming a Stage.
Use: setupStage(Consumer<Stage>), setupApplication(Class<? extends Application>), setupScene(Supplier<Scene>) or setupSceneRoot(Supplier<Parent>)

3. Individual Fixtures

To setup individual Stages, Scenes or Nodes use setupFixture(Runnable) and setupFixture(Callable).

Internal Context

Is internally responsible for handle the registered Stage for attachments, handle timeouts, provide the Application for the Toolkit launch and execute the setup in the JavaFX thread. The primary Stage is constructed by the platform.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static void`	`cleanupApplication(Application application)`	Performs the clean up of the application.
`static void`	`cleanupStages()`	Runs on the `JavaFX Application Thread`: Hides all windows returned from `JavaVersionAdapter.getWindows()` and returns once finished.
`static void`	`hideStage()`	Runs on the `JavaFX Application Thread`: Hides the registered stage via `Window.hide()` and returns once finished.
`static boolean`	`isFXApplicationThreadRunning()`	Detects if the JavaFx Application Thread is currently running.
`static Stage`	`registerPrimaryStage()`	Sets up the `PrimaryStageApplication` to use in tests, prevents it from shutting down when the last window is closed, and returns the `Stage` from `Application.start(Stage)`.
`static Stage`	`registerStage(Supplier<Stage> stageSupplier)`	Runs the stageSupplier on the `JavaFX Application Thread`, registers the supplied stage, and returns that stage.
`static Application`	`setupApplication(Class<? extends Application> applicationClass, String... applicationArgs)`	Sets up the given application with its given arguments and returns that application once finished.
`static Application`	`setupApplication(Supplier<Application> applicationSupplier)`	Sets up the supplied application and returns that application once finished.
`static void`	`setupFixture(Runnable runnable)`	Runs the given `runnable` on the `JavaFX Application Thread` and returns once finished.
`static <T> T`	`setupFixture(Callable<T> callable)`	Runs the given `callable` on the `JavaFX Application Thread` and returns once finished.
`static Scene`	`setupScene(Supplier<Scene> sceneSupplier)`	Runs the `sceneSupplier` on the `JavaFX Application Thread`, sets the registered stage's scene to the supplied scene, and returns the supplied scene once finished.
`static Parent`	`setupSceneRoot(Supplier<Parent> sceneRootSupplier)`	Runs the `sceneRootSupplier` on the `JavaFX Application Thread`, sets the registered stage's scene's root node to the supplied root node, and returns the supplied root node once finished.
`static Stage`	`setupStage(Consumer<Stage> stageConsumer)`	Sets up the registered stage by passing it into the given `stageConsumer` on the `JavaFX Application Thread` and returns the stage once finished.
`static void`	`showStage()`	Runs on the `JavaFX Application Thread`: Shows the registered stage via `Stage.show()`, moves it to the front via `Stage.toFront()`, and returns once finished.
`static FxToolkitContext`	`toolkitContext()`	Returns the internal context.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - registerPrimaryStage
```
public static Stage registerPrimaryStage()
                                  throws TimeoutException
```
    Sets up the PrimaryStageApplication to use in tests, prevents it from shutting down when the last window is closed, and returns the Stage from Application.start(Stage).
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getLaunchTimeoutInMillis()
  - registerStage
```
public static Stage registerStage(Supplier<Stage> stageSupplier)
                           throws TimeoutException
```
    Runs the stageSupplier on the JavaFX Application Thread, registers the supplied stage, and returns that stage.
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getSetupTimeoutInMillis()
  - setupStage
```
public static Stage setupStage(Consumer<Stage> stageConsumer)
                        throws TimeoutException
```
    Sets up the registered stage by passing it into the given stageConsumer on the JavaFX Application Thread and returns the stage once finished.
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getSetupTimeoutInMillis()
  - setupApplication
```
public static Application setupApplication(Class<? extends Application> applicationClass,
                                           String... applicationArgs)
                                    throws TimeoutException
```
    Sets up the given application with its given arguments and returns that application once finished.
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getSetupTimeoutInMillis()
  - setupApplication
```
public static Application setupApplication(Supplier<Application> applicationSupplier)
                                    throws TimeoutException
```
    Sets up the supplied application and returns that application once finished.
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getSetupTimeoutInMillis()
  - cleanupApplication
```
public static void cleanupApplication(Application application)
                               throws TimeoutException
```
    Performs the clean up of the application. This is done by calling ToolkitService.cleanupApplication(Application) (which usually calls the stop method of the application).
    
    Parameters:
    
    application - the application to clean up
    
    Throws:
    
    TimeoutException - if cleanup is not finished before FxToolkitContext.getSetupTimeoutInMillis() or the FX Application Thread is not running
  - setupScene
```
public static Scene setupScene(Supplier<Scene> sceneSupplier)
                        throws TimeoutException
```
    Runs the sceneSupplier on the JavaFX Application Thread, sets the registered stage's scene to the supplied scene, and returns the supplied scene once finished.
    
    Throws:
    
    TimeoutException - if execution is not finished before FxToolkitContext.getSetupTimeoutInMillis()
  - setupSceneRoot
```
public static Parent setupSceneRoot(Supplier<Parent> sceneRootSupplier)
                             throws TimeoutException
```
    Runs the sceneRootSupplier on the JavaFX Application Thread, sets the registered stage's scene's root node to the supplied root node, and returns the supplied root node once finished.
    
    Throws:
    
    TimeoutException
  - setupFixture
```
public static void setupFixture(Runnable runnable)
                         throws TimeoutException
```
    Runs the given runnable on the JavaFX Application Thread and returns once finished.
    
    Throws:
    
    TimeoutException
  - setupFixture
```
public static <T> T setupFixture(Callable<T> callable)
                          throws TimeoutException
```
    Runs the given callable on the JavaFX Application Thread and returns once finished. before returning.
    
    Throws:
    
    TimeoutException
  - showStage
```
public static void showStage()
                      throws TimeoutException
```
    Runs on the JavaFX Application Thread: Shows the registered stage via Stage.show(), moves it to the front via Stage.toFront(), and returns once finished.
    
    Throws:
    
    TimeoutException
  - hideStage
```
public static void hideStage()
                      throws TimeoutException
```
    Runs on the JavaFX Application Thread: Hides the registered stage via Window.hide() and returns once finished.
    
    Throws:
    
    TimeoutException
  - cleanupStages
```
public static void cleanupStages()
                          throws TimeoutException
```
    Runs on the JavaFX Application Thread: Hides all windows returned from JavaVersionAdapter.getWindows() and returns once finished.
    
    Throws:
    
    TimeoutException
  - toolkitContext
```
public static FxToolkitContext toolkitContext()
```
    Returns the internal context.
  - isFXApplicationThreadRunning
```
public static boolean isFXApplicationThreadRunning()
```
    Detects if the JavaFx Application Thread is currently running.
    
    Returns:
    
    true if the FX Application Thread is running, false otherwise

Class FxToolkit

Overview

1. Container Fixtures

2. Content Fixtures

3. Individual Fixtures

Internal Context

Method Summary

Methods inherited from class java.lang.Object

Method Detail

registerPrimaryStage

registerStage

setupStage

setupApplication

setupApplication

cleanupApplication

setupScene

setupSceneRoot

setupFixture

setupFixture

showStage

hideStage

cleanupStages

toolkitContext

isFXApplicationThreadRunning