# Migration Guide

This guide documents all breaking API changes from the restructuring of go-extractor.

All core interfaces (`Browser`, `Document`, `Node`, `CookieJar`, `InteractiveBrowser`) are **unchanged**.

## Type and Function Renames

```
extractor.NewPlayWrightBrowser       -> extractor.NewBrowser
extractor.PlayWrightBrowserOptions   -> extractor.BrowserOptions
extractor.PlayWrightBrowserSelection -> extractor.BrowserSelection

extractor.PlayWrightBrowserSelectionChromium -> extractor.BrowserChromium
extractor.PlayWrightBrowserSelectionFirefox  -> extractor.BrowserFirefox
extractor.PlayWrightBrowserSelectionWebKit   -> extractor.BrowserWebKit
```

## Field Renames (inside BrowserOptions)

```
.PlayWrightServerAddress      -> .ServerAddress
.DontLaunchOnConnectFailure   -> .RequireServer
```

The `RequireServer` field is semantically identical to `DontLaunchOnConnectFailure`:

- Old: `DontLaunchOnConnectFailure: true` meant "fail if can't connect to server"
- New: `RequireServer: true` means the same thing

## New Helper

```go
extractor.DeferClose(closer)
```

Nil-safe defer close helper. Replaces the `deferClose` functions that were previously copy-pasted across packages.