browser_launch.go RawHistoryFolder

1package port
2
3import (
4	"context"
5	"io"
6)
7
8// BrowserWindowOpener opens browser URLs received through the launch relay.
9type BrowserWindowOpener interface {
10	OpenExternalURL(ctx context.Context, url string) error
11	OpenFreshWindow(ctx context.Context, url string) error
12}
13
14// BrowserLaunchRelay delivers browser URL launch requests.
15type BrowserLaunchRelay interface {
16	// DeliverOpenExternalURL attempts to deliver a request to open an external URL.
17	// The bool reports whether the relay accepted the request; false means the
18	// caller should treat it as undelivered and try another path.
19	// An error may still be returned with delivered=true when the relay accepted
20	// the request but could not confirm completion before the caller timed out.
21	DeliverOpenExternalURL(ctx context.Context, url string) (bool, error)
22	// DeliverOpenFreshWindow attempts to deliver a request that must open in a
23	// new browser window, independently of external-link workspace settings.
24	DeliverOpenFreshWindow(ctx context.Context, url string) (bool, error)
25	Listen(ctx context.Context, opener BrowserWindowOpener) (io.Closer, error)
26}
27
28// AlreadyRunningAppRelaunchHandlerSetter configures a handler for CEF relaunches.
29type AlreadyRunningAppRelaunchHandlerSetter interface {
30	SetAlreadyRunningAppRelaunchHandler(func(string))
31}