Add cdp support for xpath scrapers (#625)

Co-authored-by: WithoutPants <53250216+WithoutPants@users.noreply.github.com>

vendor/github.com/chromedp/cdproto/browser/browser.go

@@ -0,0 +1,525 @@
+// Package browser provides the Chrome DevTools Protocol
+// commands, types, and events for the Browser domain.
+//
+// The Browser domain defines methods and events for browser managing.
+//
+// Generated by the cdproto-gen command.
+package browser
+
+// Code generated by cdproto-gen. DO NOT EDIT.
+
+import (
+	"context"
+
+	"github.com/chromedp/cdproto/cdp"
+	"github.com/chromedp/cdproto/target"
+)
+
+// SetPermissionParams set permission settings for given origin.
+type SetPermissionParams struct {
+	Permission       *PermissionDescriptor `json:"permission"`                 // Descriptor of permission to override.
+	Setting          PermissionSetting     `json:"setting"`                    // Setting of the permission.
+	Origin           string                `json:"origin,omitempty"`           // Origin the permission applies to, all origins if not specified.
+	BrowserContextID cdp.BrowserContextID  `json:"browserContextId,omitempty"` // Context to override. When omitted, default browser context is used.
+}
+
+// SetPermission set permission settings for given origin.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-setPermission
+//
+// parameters:
+//   permission - Descriptor of permission to override.
+//   setting - Setting of the permission.
+func SetPermission(permission *PermissionDescriptor, setting PermissionSetting) *SetPermissionParams {
+	return &SetPermissionParams{
+		Permission: permission,
+		Setting:    setting,
+	}
+}
+
+// WithOrigin origin the permission applies to, all origins if not specified.
+func (p SetPermissionParams) WithOrigin(origin string) *SetPermissionParams {
+	p.Origin = origin
+	return &p
+}
+
+// WithBrowserContextID context to override. When omitted, default browser
+// context is used.
+func (p SetPermissionParams) WithBrowserContextID(browserContextID cdp.BrowserContextID) *SetPermissionParams {
+	p.BrowserContextID = browserContextID
+	return &p
+}
+
+// Do executes Browser.setPermission against the provided context.
+func (p *SetPermissionParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandSetPermission, p, nil)
+}
+
+// GrantPermissionsParams grant specific permissions to the given origin and
+// reject all others.
+type GrantPermissionsParams struct {
+	Permissions      []PermissionType     `json:"permissions"`
+	Origin           string               `json:"origin,omitempty"`           // Origin the permission applies to, all origins if not specified.
+	BrowserContextID cdp.BrowserContextID `json:"browserContextId,omitempty"` // BrowserContext to override permissions. When omitted, default browser context is used.
+}
+
+// GrantPermissions grant specific permissions to the given origin and reject
+// all others.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-grantPermissions
+//
+// parameters:
+//   permissions
+func GrantPermissions(permissions []PermissionType) *GrantPermissionsParams {
+	return &GrantPermissionsParams{
+		Permissions: permissions,
+	}
+}
+
+// WithOrigin origin the permission applies to, all origins if not specified.
+func (p GrantPermissionsParams) WithOrigin(origin string) *GrantPermissionsParams {
+	p.Origin = origin
+	return &p
+}
+
+// WithBrowserContextID browserContext to override permissions. When omitted,
+// default browser context is used.
+func (p GrantPermissionsParams) WithBrowserContextID(browserContextID cdp.BrowserContextID) *GrantPermissionsParams {
+	p.BrowserContextID = browserContextID
+	return &p
+}
+
+// Do executes Browser.grantPermissions against the provided context.
+func (p *GrantPermissionsParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandGrantPermissions, p, nil)
+}
+
+// ResetPermissionsParams reset all permission management for all origins.
+type ResetPermissionsParams struct {
+	BrowserContextID cdp.BrowserContextID `json:"browserContextId,omitempty"` // BrowserContext to reset permissions. When omitted, default browser context is used.
+}
+
+// ResetPermissions reset all permission management for all origins.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-resetPermissions
+//
+// parameters:
+func ResetPermissions() *ResetPermissionsParams {
+	return &ResetPermissionsParams{}
+}
+
+// WithBrowserContextID browserContext to reset permissions. When omitted,
+// default browser context is used.
+func (p ResetPermissionsParams) WithBrowserContextID(browserContextID cdp.BrowserContextID) *ResetPermissionsParams {
+	p.BrowserContextID = browserContextID
+	return &p
+}
+
+// Do executes Browser.resetPermissions against the provided context.
+func (p *ResetPermissionsParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandResetPermissions, p, nil)
+}
+
+// SetDownloadBehaviorParams set the behavior when downloading a file.
+type SetDownloadBehaviorParams struct {
+	Behavior         SetDownloadBehaviorBehavior `json:"behavior"`                   // Whether to allow all or deny all download requests, or use default Chrome behavior if available (otherwise deny). |allowAndName| allows download and names files according to their dowmload guids.
+	BrowserContextID cdp.BrowserContextID        `json:"browserContextId,omitempty"` // BrowserContext to set download behavior. When omitted, default browser context is used.
+	DownloadPath     string                      `json:"downloadPath,omitempty"`     // The default path to save downloaded files to. This is required if behavior is set to 'allow' or 'allowAndName'.
+}
+
+// SetDownloadBehavior set the behavior when downloading a file.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-setDownloadBehavior
+//
+// parameters:
+//   behavior - Whether to allow all or deny all download requests, or use default Chrome behavior if available (otherwise deny). |allowAndName| allows download and names files according to their dowmload guids.
+func SetDownloadBehavior(behavior SetDownloadBehaviorBehavior) *SetDownloadBehaviorParams {
+	return &SetDownloadBehaviorParams{
+		Behavior: behavior,
+	}
+}
+
+// WithBrowserContextID browserContext to set download behavior. When
+// omitted, default browser context is used.
+func (p SetDownloadBehaviorParams) WithBrowserContextID(browserContextID cdp.BrowserContextID) *SetDownloadBehaviorParams {
+	p.BrowserContextID = browserContextID
+	return &p
+}
+
+// WithDownloadPath the default path to save downloaded files to. This is
+// required if behavior is set to 'allow' or 'allowAndName'.
+func (p SetDownloadBehaviorParams) WithDownloadPath(downloadPath string) *SetDownloadBehaviorParams {
+	p.DownloadPath = downloadPath
+	return &p
+}
+
+// Do executes Browser.setDownloadBehavior against the provided context.
+func (p *SetDownloadBehaviorParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandSetDownloadBehavior, p, nil)
+}
+
+// CloseParams close browser gracefully.
+type CloseParams struct{}
+
+// Close close browser gracefully.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-close
+func Close() *CloseParams {
+	return &CloseParams{}
+}
+
+// Do executes Browser.close against the provided context.
+func (p *CloseParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandClose, nil, nil)
+}
+
+// CrashParams crashes browser on the main thread.
+type CrashParams struct{}
+
+// Crash crashes browser on the main thread.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-crash
+func Crash() *CrashParams {
+	return &CrashParams{}
+}
+
+// Do executes Browser.crash against the provided context.
+func (p *CrashParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandCrash, nil, nil)
+}
+
+// CrashGpuProcessParams crashes GPU process.
+type CrashGpuProcessParams struct{}
+
+// CrashGpuProcess crashes GPU process.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-crashGpuProcess
+func CrashGpuProcess() *CrashGpuProcessParams {
+	return &CrashGpuProcessParams{}
+}
+
+// Do executes Browser.crashGpuProcess against the provided context.
+func (p *CrashGpuProcessParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandCrashGpuProcess, nil, nil)
+}
+
+// GetVersionParams returns version information.
+type GetVersionParams struct{}
+
+// GetVersion returns version information.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getVersion
+func GetVersion() *GetVersionParams {
+	return &GetVersionParams{}
+}
+
+// GetVersionReturns return values.
+type GetVersionReturns struct {
+	ProtocolVersion string `json:"protocolVersion,omitempty"` // Protocol version.
+	Product         string `json:"product,omitempty"`         // Product name.
+	Revision        string `json:"revision,omitempty"`        // Product revision.
+	UserAgent       string `json:"userAgent,omitempty"`       // User-Agent.
+	JsVersion       string `json:"jsVersion,omitempty"`       // V8 version.
+}
+
+// Do executes Browser.getVersion against the provided context.
+//
+// returns:
+//   protocolVersion - Protocol version.
+//   product - Product name.
+//   revision - Product revision.
+//   userAgent - User-Agent.
+//   jsVersion - V8 version.
+func (p *GetVersionParams) Do(ctx context.Context) (protocolVersion string, product string, revision string, userAgent string, jsVersion string, err error) {
+	// execute
+	var res GetVersionReturns
+	err = cdp.Execute(ctx, CommandGetVersion, nil, &res)
+	if err != nil {
+		return "", "", "", "", "", err
+	}
+
+	return res.ProtocolVersion, res.Product, res.Revision, res.UserAgent, res.JsVersion, nil
+}
+
+// GetBrowserCommandLineParams returns the command line switches for the
+// browser process if, and only if --enable-automation is on the commandline.
+type GetBrowserCommandLineParams struct{}
+
+// GetBrowserCommandLine returns the command line switches for the browser
+// process if, and only if --enable-automation is on the commandline.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getBrowserCommandLine
+func GetBrowserCommandLine() *GetBrowserCommandLineParams {
+	return &GetBrowserCommandLineParams{}
+}
+
+// GetBrowserCommandLineReturns return values.
+type GetBrowserCommandLineReturns struct {
+	Arguments []string `json:"arguments,omitempty"` // Commandline parameters
+}
+
+// Do executes Browser.getBrowserCommandLine against the provided context.
+//
+// returns:
+//   arguments - Commandline parameters
+func (p *GetBrowserCommandLineParams) Do(ctx context.Context) (arguments []string, err error) {
+	// execute
+	var res GetBrowserCommandLineReturns
+	err = cdp.Execute(ctx, CommandGetBrowserCommandLine, nil, &res)
+	if err != nil {
+		return nil, err
+	}
+
+	return res.Arguments, nil
+}
+
+// GetHistogramsParams get Chrome histograms.
+type GetHistogramsParams struct {
+	Query string `json:"query,omitempty"` // Requested substring in name. Only histograms which have query as a substring in their name are extracted. An empty or absent query returns all histograms.
+	Delta bool   `json:"delta,omitempty"` // If true, retrieve delta since last call.
+}
+
+// GetHistograms get Chrome histograms.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getHistograms
+//
+// parameters:
+func GetHistograms() *GetHistogramsParams {
+	return &GetHistogramsParams{}
+}
+
+// WithQuery requested substring in name. Only histograms which have query as
+// a substring in their name are extracted. An empty or absent query returns all
+// histograms.
+func (p GetHistogramsParams) WithQuery(query string) *GetHistogramsParams {
+	p.Query = query
+	return &p
+}
+
+// WithDelta if true, retrieve delta since last call.
+func (p GetHistogramsParams) WithDelta(delta bool) *GetHistogramsParams {
+	p.Delta = delta
+	return &p
+}
+
+// GetHistogramsReturns return values.
+type GetHistogramsReturns struct {
+	Histograms []*Histogram `json:"histograms,omitempty"` // Histograms.
+}
+
+// Do executes Browser.getHistograms against the provided context.
+//
+// returns:
+//   histograms - Histograms.
+func (p *GetHistogramsParams) Do(ctx context.Context) (histograms []*Histogram, err error) {
+	// execute
+	var res GetHistogramsReturns
+	err = cdp.Execute(ctx, CommandGetHistograms, p, &res)
+	if err != nil {
+		return nil, err
+	}
+
+	return res.Histograms, nil
+}
+
+// GetHistogramParams get a Chrome histogram by name.
+type GetHistogramParams struct {
+	Name  string `json:"name"`            // Requested histogram name.
+	Delta bool   `json:"delta,omitempty"` // If true, retrieve delta since last call.
+}
+
+// GetHistogram get a Chrome histogram by name.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getHistogram
+//
+// parameters:
+//   name - Requested histogram name.
+func GetHistogram(name string) *GetHistogramParams {
+	return &GetHistogramParams{
+		Name: name,
+	}
+}
+
+// WithDelta if true, retrieve delta since last call.
+func (p GetHistogramParams) WithDelta(delta bool) *GetHistogramParams {
+	p.Delta = delta
+	return &p
+}
+
+// GetHistogramReturns return values.
+type GetHistogramReturns struct {
+	Histogram *Histogram `json:"histogram,omitempty"` // Histogram.
+}
+
+// Do executes Browser.getHistogram against the provided context.
+//
+// returns:
+//   histogram - Histogram.
+func (p *GetHistogramParams) Do(ctx context.Context) (histogram *Histogram, err error) {
+	// execute
+	var res GetHistogramReturns
+	err = cdp.Execute(ctx, CommandGetHistogram, p, &res)
+	if err != nil {
+		return nil, err
+	}
+
+	return res.Histogram, nil
+}
+
+// GetWindowBoundsParams get position and size of the browser window.
+type GetWindowBoundsParams struct {
+	WindowID WindowID `json:"windowId"` // Browser window id.
+}
+
+// GetWindowBounds get position and size of the browser window.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getWindowBounds
+//
+// parameters:
+//   windowID - Browser window id.
+func GetWindowBounds(windowID WindowID) *GetWindowBoundsParams {
+	return &GetWindowBoundsParams{
+		WindowID: windowID,
+	}
+}
+
+// GetWindowBoundsReturns return values.
+type GetWindowBoundsReturns struct {
+	Bounds *Bounds `json:"bounds,omitempty"` // Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
+}
+
+// Do executes Browser.getWindowBounds against the provided context.
+//
+// returns:
+//   bounds - Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
+func (p *GetWindowBoundsParams) Do(ctx context.Context) (bounds *Bounds, err error) {
+	// execute
+	var res GetWindowBoundsReturns
+	err = cdp.Execute(ctx, CommandGetWindowBounds, p, &res)
+	if err != nil {
+		return nil, err
+	}
+
+	return res.Bounds, nil
+}
+
+// GetWindowForTargetParams get the browser window that contains the devtools
+// target.
+type GetWindowForTargetParams struct {
+	TargetID target.ID `json:"targetId,omitempty"` // Devtools agent host id. If called as a part of the session, associated targetId is used.
+}
+
+// GetWindowForTarget get the browser window that contains the devtools
+// target.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-getWindowForTarget
+//
+// parameters:
+func GetWindowForTarget() *GetWindowForTargetParams {
+	return &GetWindowForTargetParams{}
+}
+
+// WithTargetID devtools agent host id. If called as a part of the session,
+// associated targetId is used.
+func (p GetWindowForTargetParams) WithTargetID(targetID target.ID) *GetWindowForTargetParams {
+	p.TargetID = targetID
+	return &p
+}
+
+// GetWindowForTargetReturns return values.
+type GetWindowForTargetReturns struct {
+	WindowID WindowID `json:"windowId,omitempty"` // Browser window id.
+	Bounds   *Bounds  `json:"bounds,omitempty"`   // Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
+}
+
+// Do executes Browser.getWindowForTarget against the provided context.
+//
+// returns:
+//   windowID - Browser window id.
+//   bounds - Bounds information of the window. When window state is 'minimized', the restored window position and size are returned.
+func (p *GetWindowForTargetParams) Do(ctx context.Context) (windowID WindowID, bounds *Bounds, err error) {
+	// execute
+	var res GetWindowForTargetReturns
+	err = cdp.Execute(ctx, CommandGetWindowForTarget, p, &res)
+	if err != nil {
+		return 0, nil, err
+	}
+
+	return res.WindowID, res.Bounds, nil
+}
+
+// SetWindowBoundsParams set position and/or size of the browser window.
+type SetWindowBoundsParams struct {
+	WindowID WindowID `json:"windowId"` // Browser window id.
+	Bounds   *Bounds  `json:"bounds"`   // New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
+}
+
+// SetWindowBounds set position and/or size of the browser window.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-setWindowBounds
+//
+// parameters:
+//   windowID - Browser window id.
+//   bounds - New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
+func SetWindowBounds(windowID WindowID, bounds *Bounds) *SetWindowBoundsParams {
+	return &SetWindowBoundsParams{
+		WindowID: windowID,
+		Bounds:   bounds,
+	}
+}
+
+// Do executes Browser.setWindowBounds against the provided context.
+func (p *SetWindowBoundsParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandSetWindowBounds, p, nil)
+}
+
+// SetDockTileParams set dock tile details, platform-specific.
+type SetDockTileParams struct {
+	BadgeLabel string `json:"badgeLabel,omitempty"`
+	Image      string `json:"image,omitempty"` // Png encoded image.
+}
+
+// SetDockTile set dock tile details, platform-specific.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-setDockTile
+//
+// parameters:
+func SetDockTile() *SetDockTileParams {
+	return &SetDockTileParams{}
+}
+
+// WithBadgeLabel [no description].
+func (p SetDockTileParams) WithBadgeLabel(badgeLabel string) *SetDockTileParams {
+	p.BadgeLabel = badgeLabel
+	return &p
+}
+
+// WithImage png encoded image.
+func (p SetDockTileParams) WithImage(image string) *SetDockTileParams {
+	p.Image = image
+	return &p
+}
+
+// Do executes Browser.setDockTile against the provided context.
+func (p *SetDockTileParams) Do(ctx context.Context) (err error) {
+	return cdp.Execute(ctx, CommandSetDockTile, p, nil)
+}
+
+// Command names.
+const (
+	CommandSetPermission         = "Browser.setPermission"
+	CommandGrantPermissions      = "Browser.grantPermissions"
+	CommandResetPermissions      = "Browser.resetPermissions"
+	CommandSetDownloadBehavior   = "Browser.setDownloadBehavior"
+	CommandClose                 = "Browser.close"
+	CommandCrash                 = "Browser.crash"
+	CommandCrashGpuProcess       = "Browser.crashGpuProcess"
+	CommandGetVersion            = "Browser.getVersion"
+	CommandGetBrowserCommandLine = "Browser.getBrowserCommandLine"
+	CommandGetHistograms         = "Browser.getHistograms"
+	CommandGetHistogram          = "Browser.getHistogram"
+	CommandGetWindowBounds       = "Browser.getWindowBounds"
+	CommandGetWindowForTarget    = "Browser.getWindowForTarget"
+	CommandSetWindowBounds       = "Browser.setWindowBounds"
+	CommandSetDockTile           = "Browser.setDockTile"
+)

vendor/github.com/chromedp/cdproto/browser/types.go

@@ -0,0 +1,315 @@
+package browser
+
+// Code generated by cdproto-gen. DO NOT EDIT.
+
+import (
+	"errors"
+
+	"github.com/mailru/easyjson"
+	"github.com/mailru/easyjson/jlexer"
+	"github.com/mailru/easyjson/jwriter"
+)
+
+// WindowID [no description].
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-WindowID
+type WindowID int64
+
+// Int64 returns the WindowID as int64 value.
+func (t WindowID) Int64() int64 {
+	return int64(t)
+}
+
+// WindowState the state of the browser window.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-WindowState
+type WindowState string
+
+// String returns the WindowState as string value.
+func (t WindowState) String() string {
+	return string(t)
+}
+
+// WindowState values.
+const (
+	WindowStateNormal     WindowState = "normal"
+	WindowStateMinimized  WindowState = "minimized"
+	WindowStateMaximized  WindowState = "maximized"
+	WindowStateFullscreen WindowState = "fullscreen"
+)
+
+// MarshalEasyJSON satisfies easyjson.Marshaler.
+func (t WindowState) MarshalEasyJSON(out *jwriter.Writer) {
+	out.String(string(t))
+}
+
+// MarshalJSON satisfies json.Marshaler.
+func (t WindowState) MarshalJSON() ([]byte, error) {
+	return easyjson.Marshal(t)
+}
+
+// UnmarshalEasyJSON satisfies easyjson.Unmarshaler.
+func (t *WindowState) UnmarshalEasyJSON(in *jlexer.Lexer) {
+	switch WindowState(in.String()) {
+	case WindowStateNormal:
+		*t = WindowStateNormal
+	case WindowStateMinimized:
+		*t = WindowStateMinimized
+	case WindowStateMaximized:
+		*t = WindowStateMaximized
+	case WindowStateFullscreen:
+		*t = WindowStateFullscreen
+
+	default:
+		in.AddError(errors.New("unknown WindowState value"))
+	}
+}
+
+// UnmarshalJSON satisfies json.Unmarshaler.
+func (t *WindowState) UnmarshalJSON(buf []byte) error {
+	return easyjson.Unmarshal(buf, t)
+}
+
+// Bounds browser window bounds information.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-Bounds
+type Bounds struct {
+	Left        int64       `json:"left,omitempty"`        // The offset from the left edge of the screen to the window in pixels.
+	Top         int64       `json:"top,omitempty"`         // The offset from the top edge of the screen to the window in pixels.
+	Width       int64       `json:"width,omitempty"`       // The window width in pixels.
+	Height      int64       `json:"height,omitempty"`      // The window height in pixels.
+	WindowState WindowState `json:"windowState,omitempty"` // The window state. Default to normal.
+}
+
+// PermissionType [no description].
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-PermissionType
+type PermissionType string
+
+// String returns the PermissionType as string value.
+func (t PermissionType) String() string {
+	return string(t)
+}
+
+// PermissionType values.
+const (
+	PermissionTypeAccessibilityEvents      PermissionType = "accessibilityEvents"
+	PermissionTypeAudioCapture             PermissionType = "audioCapture"
+	PermissionTypeBackgroundSync           PermissionType = "backgroundSync"
+	PermissionTypeBackgroundFetch          PermissionType = "backgroundFetch"
+	PermissionTypeClipboardReadWrite       PermissionType = "clipboardReadWrite"
+	PermissionTypeClipboardSanitizedWrite  PermissionType = "clipboardSanitizedWrite"
+	PermissionTypeDurableStorage           PermissionType = "durableStorage"
+	PermissionTypeFlash                    PermissionType = "flash"
+	PermissionTypeGeolocation              PermissionType = "geolocation"
+	PermissionTypeMidi                     PermissionType = "midi"
+	PermissionTypeMidiSysex                PermissionType = "midiSysex"
+	PermissionTypeNfc                      PermissionType = "nfc"
+	PermissionTypeNotifications            PermissionType = "notifications"
+	PermissionTypePaymentHandler           PermissionType = "paymentHandler"
+	PermissionTypePeriodicBackgroundSync   PermissionType = "periodicBackgroundSync"
+	PermissionTypeProtectedMediaIdentifier PermissionType = "protectedMediaIdentifier"
+	PermissionTypeSensors                  PermissionType = "sensors"
+	PermissionTypeVideoCapture             PermissionType = "videoCapture"
+	PermissionTypeIdleDetection            PermissionType = "idleDetection"
+	PermissionTypeWakeLockScreen           PermissionType = "wakeLockScreen"
+	PermissionTypeWakeLockSystem           PermissionType = "wakeLockSystem"
+)
+
+// MarshalEasyJSON satisfies easyjson.Marshaler.
+func (t PermissionType) MarshalEasyJSON(out *jwriter.Writer) {
+	out.String(string(t))
+}
+
+// MarshalJSON satisfies json.Marshaler.
+func (t PermissionType) MarshalJSON() ([]byte, error) {
+	return easyjson.Marshal(t)
+}
+
+// UnmarshalEasyJSON satisfies easyjson.Unmarshaler.
+func (t *PermissionType) UnmarshalEasyJSON(in *jlexer.Lexer) {
+	switch PermissionType(in.String()) {
+	case PermissionTypeAccessibilityEvents:
+		*t = PermissionTypeAccessibilityEvents
+	case PermissionTypeAudioCapture:
+		*t = PermissionTypeAudioCapture
+	case PermissionTypeBackgroundSync:
+		*t = PermissionTypeBackgroundSync
+	case PermissionTypeBackgroundFetch:
+		*t = PermissionTypeBackgroundFetch
+	case PermissionTypeClipboardReadWrite:
+		*t = PermissionTypeClipboardReadWrite
+	case PermissionTypeClipboardSanitizedWrite:
+		*t = PermissionTypeClipboardSanitizedWrite
+	case PermissionTypeDurableStorage:
+		*t = PermissionTypeDurableStorage
+	case PermissionTypeFlash:
+		*t = PermissionTypeFlash
+	case PermissionTypeGeolocation:
+		*t = PermissionTypeGeolocation
+	case PermissionTypeMidi:
+		*t = PermissionTypeMidi
+	case PermissionTypeMidiSysex:
+		*t = PermissionTypeMidiSysex
+	case PermissionTypeNfc:
+		*t = PermissionTypeNfc
+	case PermissionTypeNotifications:
+		*t = PermissionTypeNotifications
+	case PermissionTypePaymentHandler:
+		*t = PermissionTypePaymentHandler
+	case PermissionTypePeriodicBackgroundSync:
+		*t = PermissionTypePeriodicBackgroundSync
+	case PermissionTypeProtectedMediaIdentifier:
+		*t = PermissionTypeProtectedMediaIdentifier
+	case PermissionTypeSensors:
+		*t = PermissionTypeSensors
+	case PermissionTypeVideoCapture:
+		*t = PermissionTypeVideoCapture
+	case PermissionTypeIdleDetection:
+		*t = PermissionTypeIdleDetection
+	case PermissionTypeWakeLockScreen:
+		*t = PermissionTypeWakeLockScreen
+	case PermissionTypeWakeLockSystem:
+		*t = PermissionTypeWakeLockSystem
+
+	default:
+		in.AddError(errors.New("unknown PermissionType value"))
+	}
+}
+
+// UnmarshalJSON satisfies json.Unmarshaler.
+func (t *PermissionType) UnmarshalJSON(buf []byte) error {
+	return easyjson.Unmarshal(buf, t)
+}
+
+// PermissionSetting [no description].
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-PermissionSetting
+type PermissionSetting string
+
+// String returns the PermissionSetting as string value.
+func (t PermissionSetting) String() string {
+	return string(t)
+}
+
+// PermissionSetting values.
+const (
+	PermissionSettingGranted PermissionSetting = "granted"
+	PermissionSettingDenied  PermissionSetting = "denied"
+	PermissionSettingPrompt  PermissionSetting = "prompt"
+)
+
+// MarshalEasyJSON satisfies easyjson.Marshaler.
+func (t PermissionSetting) MarshalEasyJSON(out *jwriter.Writer) {
+	out.String(string(t))
+}
+
+// MarshalJSON satisfies json.Marshaler.
+func (t PermissionSetting) MarshalJSON() ([]byte, error) {
+	return easyjson.Marshal(t)
+}
+
+// UnmarshalEasyJSON satisfies easyjson.Unmarshaler.
+func (t *PermissionSetting) UnmarshalEasyJSON(in *jlexer.Lexer) {
+	switch PermissionSetting(in.String()) {
+	case PermissionSettingGranted:
+		*t = PermissionSettingGranted
+	case PermissionSettingDenied:
+		*t = PermissionSettingDenied
+	case PermissionSettingPrompt:
+		*t = PermissionSettingPrompt
+
+	default:
+		in.AddError(errors.New("unknown PermissionSetting value"))
+	}
+}
+
+// UnmarshalJSON satisfies json.Unmarshaler.
+func (t *PermissionSetting) UnmarshalJSON(buf []byte) error {
+	return easyjson.Unmarshal(buf, t)
+}
+
+// PermissionDescriptor definition of PermissionDescriptor defined in the
+// Permissions API:
+// https://w3c.github.io/permissions/#dictdef-permissiondescriptor.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-PermissionDescriptor
+type PermissionDescriptor struct {
+	Name                     string `json:"name"`                               // Name of permission. See https://cs.chromium.org/chromium/src/third_party/blink/renderer/modules/permissions/permission_descriptor.idl for valid permission names.
+	Sysex                    bool   `json:"sysex,omitempty"`                    // For "midi" permission, may also specify sysex control.
+	UserVisibleOnly          bool   `json:"userVisibleOnly,omitempty"`          // For "push" permission, may specify userVisibleOnly. Note that userVisibleOnly = true is the only currently supported type.
+	Type                     string `json:"type,omitempty"`                     // For "wake-lock" permission, must specify type as either "screen" or "system".
+	AllowWithoutSanitization bool   `json:"allowWithoutSanitization,omitempty"` // For "clipboard" permission, may specify allowWithoutSanitization.
+}
+
+// Bucket chrome histogram bucket.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-Bucket
+type Bucket struct {
+	Low   int64 `json:"low"`   // Minimum value (inclusive).
+	High  int64 `json:"high"`  // Maximum value (exclusive).
+	Count int64 `json:"count"` // Number of samples.
+}
+
+// Histogram chrome histogram.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#type-Histogram
+type Histogram struct {
+	Name    string    `json:"name"`    // Name.
+	Sum     int64     `json:"sum"`     // Sum of sample values.
+	Count   int64     `json:"count"`   // Total number of samples.
+	Buckets []*Bucket `json:"buckets"` // Buckets.
+}
+
+// SetDownloadBehaviorBehavior whether to allow all or deny all download
+// requests, or use default Chrome behavior if available (otherwise deny).
+// |allowAndName| allows download and names files according to their dowmload
+// guids.
+//
+// See: https://chromedevtools.github.io/devtools-protocol/tot/Browser#method-setDownloadBehavior
+type SetDownloadBehaviorBehavior string
+
+// String returns the SetDownloadBehaviorBehavior as string value.
+func (t SetDownloadBehaviorBehavior) String() string {
+	return string(t)
+}
+
+// SetDownloadBehaviorBehavior values.
+const (
+	SetDownloadBehaviorBehaviorDeny         SetDownloadBehaviorBehavior = "deny"
+	SetDownloadBehaviorBehaviorAllow        SetDownloadBehaviorBehavior = "allow"
+	SetDownloadBehaviorBehaviorAllowAndName SetDownloadBehaviorBehavior = "allowAndName"
+	SetDownloadBehaviorBehaviorDefault      SetDownloadBehaviorBehavior = "default"
+)
+
+// MarshalEasyJSON satisfies easyjson.Marshaler.
+func (t SetDownloadBehaviorBehavior) MarshalEasyJSON(out *jwriter.Writer) {
+	out.String(string(t))
+}
+
+// MarshalJSON satisfies json.Marshaler.
+func (t SetDownloadBehaviorBehavior) MarshalJSON() ([]byte, error) {
+	return easyjson.Marshal(t)
+}
+
+// UnmarshalEasyJSON satisfies easyjson.Unmarshaler.
+func (t *SetDownloadBehaviorBehavior) UnmarshalEasyJSON(in *jlexer.Lexer) {
+	switch SetDownloadBehaviorBehavior(in.String()) {
+	case SetDownloadBehaviorBehaviorDeny:
+		*t = SetDownloadBehaviorBehaviorDeny
+	case SetDownloadBehaviorBehaviorAllow:
+		*t = SetDownloadBehaviorBehaviorAllow
+	case SetDownloadBehaviorBehaviorAllowAndName:
+		*t = SetDownloadBehaviorBehaviorAllowAndName
+	case SetDownloadBehaviorBehaviorDefault:
+		*t = SetDownloadBehaviorBehaviorDefault
+
+	default:
+		in.AddError(errors.New("unknown SetDownloadBehaviorBehavior value"))
+	}
+}
+
+// UnmarshalJSON satisfies json.Unmarshaler.
+func (t *SetDownloadBehaviorBehavior) UnmarshalJSON(buf []byte) error {
+	return easyjson.Unmarshal(buf, t)
+}