firecrawl-api / apps /java-sdk /src /test /java /com /firecrawl /BrowserTest.java
s-eto-hub's picture
Commit de nettoyage des binaires
097eaf0
Raw History Blame Contribute Delete
12.6 kB
package com.firecrawl;
import com.firecrawl.client.FirecrawlClient;
import com.firecrawl.models.BrowserCreateResponse;
import com.firecrawl.models.BrowserDeleteResponse;
import com.firecrawl.models.BrowserExecuteResponse;
import com.firecrawl.models.BrowserListResponse;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;
import static org.junit.jupiter.api.Assertions.*;
/**
* Browser Sandbox Endpoint Tests
*
* Tests the browser session management functionality of the Firecrawl Java SDK.
* These tests require FIRECRAWL_API_KEY environment variable to be set.
*
* Run with: FIRECRAWL_API_KEY=fc-xxx gradle test --tests "com.firecrawl.BrowserTest"
*/
class BrowserTest {
private static FirecrawlClient client;
@BeforeAll
static void setup() {
String apiKey = System.getenv("FIRECRAWL_API_KEY");
if (apiKey != null && !apiKey.isBlank()) {
client = FirecrawlClient.fromEnv();
}
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserCreateAndDelete() {
System.out.println("Testing browser session create and delete...");
// Create a browser session
BrowserCreateResponse createRes = client.browser();
assertNotNull(createRes, "Create response should not be null");
assertTrue(createRes.isSuccess(), "Create should succeed");
assertNotNull(createRes.getId(), "Session ID should not be null");
String sessionId = createRes.getId();
System.out.println(" Created session: " + sessionId);
// Delete the browser session
BrowserDeleteResponse deleteRes = client.deleteBrowser(sessionId);
assertNotNull(deleteRes, "Delete response should not be null");
assertTrue(deleteRes.isSuccess(), "Delete should succeed");
System.out.println("βœ“ Browser create and delete test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserCreateWithOptions() {
System.out.println("Testing browser session create with options...");
// Create a session with custom TTL and activity TTL
BrowserCreateResponse createRes = client.browser(300, 120, true);
assertNotNull(createRes, "Create response should not be null");
assertTrue(createRes.isSuccess(), "Create should succeed");
assertNotNull(createRes.getId(), "Session ID should not be null");
String sessionId = createRes.getId();
System.out.println(" Created session with options: " + sessionId);
// Clean up
client.deleteBrowser(sessionId);
System.out.println("βœ“ Browser create with options test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserExecuteBash() {
System.out.println("Testing browser execute with bash...");
// Create a session
BrowserCreateResponse createRes = client.browser();
assertTrue(createRes.isSuccess(), "Create should succeed");
String sessionId = createRes.getId();
try {
// Execute bash code
BrowserExecuteResponse execRes = client.browserExecute(sessionId, "echo 'hello from java sdk'");
assertNotNull(execRes, "Execute response should not be null");
assertTrue(execRes.isSuccess(), "Execute should succeed");
assertNotNull(execRes.getStdout(), "Stdout should not be null");
assertTrue(execRes.getStdout().contains("hello from java sdk"),
"Stdout should contain our echo output");
System.out.println(" Stdout: " + execRes.getStdout().trim());
System.out.println(" Exit code: " + execRes.getExitCode());
} finally {
// Clean up
client.deleteBrowser(sessionId);
}
System.out.println("βœ“ Browser execute bash test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserExecuteNode() {
System.out.println("Testing browser execute with node...");
// Create a session
BrowserCreateResponse createRes = client.browser();
assertTrue(createRes.isSuccess(), "Create should succeed");
String sessionId = createRes.getId();
try {
// Execute node code
BrowserExecuteResponse execRes = client.browserExecute(
sessionId, "console.log(1 + 2)", "node", null);
assertNotNull(execRes, "Execute response should not be null");
assertTrue(execRes.isSuccess(), "Execute should succeed");
System.out.println(" Stdout: " + (execRes.getStdout() != null ? execRes.getStdout().trim() : "null"));
} finally {
client.deleteBrowser(sessionId);
}
System.out.println("βœ“ Browser execute node test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserExecutePython() {
System.out.println("Testing browser execute with python...");
// Create a session
BrowserCreateResponse createRes = client.browser();
assertTrue(createRes.isSuccess(), "Create should succeed");
String sessionId = createRes.getId();
try {
// Execute python code
BrowserExecuteResponse execRes = client.browserExecute(
sessionId, "print('hello from python')", "python", null);
assertNotNull(execRes, "Execute response should not be null");
assertTrue(execRes.isSuccess(), "Execute should succeed");
System.out.println(" Stdout: " + (execRes.getStdout() != null ? execRes.getStdout().trim() : "null"));
} finally {
client.deleteBrowser(sessionId);
}
System.out.println("βœ“ Browser execute python test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserExecuteWithTimeout() {
System.out.println("Testing browser execute with custom timeout...");
// Create a session
BrowserCreateResponse createRes = client.browser();
assertTrue(createRes.isSuccess(), "Create should succeed");
String sessionId = createRes.getId();
try {
// Execute with custom timeout (60 seconds)
BrowserExecuteResponse execRes = client.browserExecute(
sessionId, "echo 'timeout test'", "bash", 60);
assertNotNull(execRes, "Execute response should not be null");
assertTrue(execRes.isSuccess(), "Execute should succeed");
System.out.println(" Stdout: " + (execRes.getStdout() != null ? execRes.getStdout().trim() : "null"));
} finally {
client.deleteBrowser(sessionId);
}
System.out.println("βœ“ Browser execute with timeout test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserListSessions() {
System.out.println("Testing list browser sessions...");
// List all sessions
BrowserListResponse listRes = client.listBrowsers();
assertNotNull(listRes, "List response should not be null");
assertTrue(listRes.isSuccess(), "List should succeed");
System.out.println(" Total sessions: " + (listRes.getSessions() != null ? listRes.getSessions().size() : 0));
System.out.println("βœ“ List browser sessions test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserListActiveFilter() {
System.out.println("Testing list browser sessions with active filter...");
// Create a session so we have at least one active
BrowserCreateResponse createRes = client.browser();
assertTrue(createRes.isSuccess(), "Create should succeed");
String sessionId = createRes.getId();
try {
// List only active sessions
BrowserListResponse listRes = client.listBrowsers("active");
assertNotNull(listRes, "List response should not be null");
assertTrue(listRes.isSuccess(), "List should succeed");
assertNotNull(listRes.getSessions(), "Sessions list should not be null");
assertFalse(listRes.getSessions().isEmpty(), "Should have at least one active session");
System.out.println(" Active sessions: " + listRes.getSessions().size());
} finally {
client.deleteBrowser(sessionId);
}
System.out.println("βœ“ List active browser sessions test passed");
}
@Test
@EnabledIfEnvironmentVariable(named = "FIRECRAWL_API_KEY", matches = ".*\\S.*")
void testBrowserFullLifecycle() {
System.out.println("Testing full browser session lifecycle...");
// 1. Create session
BrowserCreateResponse createRes = client.browser(300, 120, true);
assertTrue(createRes.isSuccess(), "Create should succeed");
assertNotNull(createRes.getId(), "Should have session ID");
String sessionId = createRes.getId();
System.out.println(" 1. Created session: " + sessionId);
// CDP URL and live view URL may be present
if (createRes.getCdpUrl() != null) {
System.out.println(" CDP URL present: true");
}
if (createRes.getLiveViewUrl() != null) {
System.out.println(" Live View URL present: true");
}
// 2. Navigate to a page
BrowserExecuteResponse navRes = client.browserExecute(
sessionId, "agent-browser open https://example.com", "bash", 30);
assertTrue(navRes.isSuccess(), "Navigation should succeed");
System.out.println(" 2. Navigated to example.com");
// 3. Take a snapshot
BrowserExecuteResponse snapRes = client.browserExecute(
sessionId, "agent-browser snapshot -i -c", "bash", 30);
assertTrue(snapRes.isSuccess(), "Snapshot should succeed");
System.out.println(" 3. Took snapshot");
// 4. Get page title
BrowserExecuteResponse titleRes = client.browserExecute(
sessionId, "agent-browser get title", "bash", 30);
assertTrue(titleRes.isSuccess(), "Get title should succeed");
System.out.println(" 4. Page title: " + (titleRes.getStdout() != null ? titleRes.getStdout().trim() : "null"));
// 5. Verify session is active
BrowserListResponse listRes = client.listBrowsers("active");
assertTrue(listRes.isSuccess(), "List should succeed");
System.out.println(" 5. Active sessions: " + (listRes.getSessions() != null ? listRes.getSessions().size() : 0));
// 6. Delete session
BrowserDeleteResponse deleteRes = client.deleteBrowser(sessionId);
assertTrue(deleteRes.isSuccess(), "Delete should succeed");
System.out.println(" 6. Deleted session");
if (deleteRes.getSessionDurationMs() != null) {
System.out.println(" Session duration: " + deleteRes.getSessionDurationMs() + "ms");
}
if (deleteRes.getCreditsBilled() != null) {
System.out.println(" Credits billed: " + deleteRes.getCreditsBilled());
}
System.out.println("βœ“ Full browser session lifecycle test passed");
}
@Test
void testBrowserExecuteRequiresSessionId() {
FirecrawlClient testClient = FirecrawlClient.builder()
.apiKey("fc-test-key")
.build();
assertThrows(NullPointerException.class, () ->
testClient.browserExecute(null, "echo test")
);
}
@Test
void testBrowserExecuteRequiresCode() {
FirecrawlClient testClient = FirecrawlClient.builder()
.apiKey("fc-test-key")
.build();
assertThrows(NullPointerException.class, () ->
testClient.browserExecute("some-session-id", null)
);
}
@Test
void testBrowserDeleteRequiresSessionId() {
FirecrawlClient testClient = FirecrawlClient.builder()
.apiKey("fc-test-key")
.build();
assertThrows(NullPointerException.class, () ->
testClient.deleteBrowser(null)
);
}
}