launch

Documentation

Index

• func GetChromeLogLevelNumber(level ChromeLogLevel) int
• func Probe(port int) bool
• func ProbeUntil(port int, wait time.Duration) error
• type ChromeLogLevel
  • func NormalizeChromeLogLevel(level ChromeLogLevel) ChromeLogLevel
• type Config
  • func (c Config) Env() []string
  • func (c Config) LogFlags() []string
  • func (c Config) Normalize() Config
• type Launcher
  • func New(cfg Config) Launcher

Functions

func GetChromeLogLevelNumber

func GetChromeLogLevelNumber(level ChromeLogLevel) int

See https://peter.sh/experiments/chromium-command-line-switches/#log-level

func Probe

func Probe(port int) bool

Probes chrome remote debugger to verify it's listening

func ProbeUntil

func ProbeUntil(port int, wait time.Duration) error

Probes chrome remote debugger until a connection is verified or wait expires

Types

type ChromeLogLevel

type ChromeLogLevel string

var (
	ChromeLogLevelInfo    ChromeLogLevel = "info"
	ChromeLogLevelWarning ChromeLogLevel = "warning"
	ChromeLogLevelError   ChromeLogLevel = "error"
	ChromeLogLevelFatal   ChromeLogLevel = "fatal"
)

func NormalizeChromeLogLevel

func NormalizeChromeLogLevel(level ChromeLogLevel) ChromeLogLevel

type Config

type Config struct {
	StartingUrl          string
	RequestedPort        int
	ChromePath           string
	ChromeFlags          []string
	LogLevel             ChromeLogLevel
	EnvironmentVariables map[string]string
	UserDataDir          string
	IgnoreDefaultFlags   bool
	IsLambdaEnv          bool
}

func (Config) Env

func (c Config) Env() []string

func (Config) LogFlags

func (c Config) LogFlags() []string

func (Config) Normalize

func (c Config) Normalize() Config

type Launcher

type Launcher interface {
	// Launches chrome
	// If a debugger port is requested and chrome is listening on that port,
	//   this will not create any resources or launch chrome
	Launch() error

	// Stops chrome and destroys resources
	// This will do nothing if Launch did not launch a new chrome
	Kill() error

	// Chrome process id
	Pid() int

	// Chrome remote debugger port
	Port() int
}

func New

func New(cfg Config) Launcher