domsnapshot

package
v0.18.5 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 8, 2018 License: MIT Imports: 6 Imported by: 0

Documentation

Overview

Package domsnapshot implements the DOMSnapshot domain. This domain facilitates obtaining document snapshots with DOM, layout, and style information.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func NewClient

func NewClient(conn *rpcc.Conn) *domainClient

NewClient returns a client for the DOMSnapshot domain with the connection set to conn.

Types

type ArrayOfStrings added in v0.18.5

type ArrayOfStrings []StringIndex

ArrayOfStrings Index of the string in the strings table.

type CaptureSnapshotArgs added in v0.18.5

type CaptureSnapshotArgs struct {
	ComputedStyles []string `json:"computedStyles"` // Whitelist of computed styles to return.
}

CaptureSnapshotArgs represents the arguments for CaptureSnapshot in the DOMSnapshot domain.

func NewCaptureSnapshotArgs added in v0.18.5

func NewCaptureSnapshotArgs(computedStyles []string) *CaptureSnapshotArgs

NewCaptureSnapshotArgs initializes CaptureSnapshotArgs with the required arguments.

type CaptureSnapshotReply added in v0.18.5

type CaptureSnapshotReply struct {
	Nodes   DOMTreeSnapshot    `json:"nodes"`   // The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
	Layout  LayoutTreeSnapshot `json:"layout"`  // The nodes in the layout tree.
	Strings []string           `json:"strings"` // Shared string table that all string properties refer to with indexes.
}

CaptureSnapshotReply represents the return values for CaptureSnapshot in the DOMSnapshot domain.

type ComputedStyle

type ComputedStyle struct {
	Properties []NameValue `json:"properties"` // Name/value pairs of computed style properties.
}

ComputedStyle A subset of the full ComputedStyle as defined by the request whitelist.

type DOMNode

type DOMNode struct {
	NodeType              int                         `json:"nodeType"`                        // `Node`'s nodeType.
	NodeName              string                      `json:"nodeName"`                        // `Node`'s nodeName.
	NodeValue             string                      `json:"nodeValue"`                       // `Node`'s nodeValue.
	TextValue             *string                     `json:"textValue,omitempty"`             // Only set for textarea elements, contains the text value.
	InputValue            *string                     `json:"inputValue,omitempty"`            // Only set for input elements, contains the input's associated text value.
	InputChecked          *bool                       `json:"inputChecked,omitempty"`          // Only set for radio and checkbox input elements, indicates if the element has been checked
	OptionSelected        *bool                       `json:"optionSelected,omitempty"`        // Only set for option elements, indicates if the element has been selected
	BackendNodeID         dom.BackendNodeID           `json:"backendNodeId"`                   // `Node`'s id, corresponds to DOM.Node.backendNodeId.
	ChildNodeIndexes      []int                       `json:"childNodeIndexes,omitempty"`      // The indexes of the node's child nodes in the `domNodes` array returned by `getSnapshot`, if any.
	Attributes            []NameValue                 `json:"attributes,omitempty"`            // Attributes of an `Element` node.
	PseudoElementIndexes  []int                       `json:"pseudoElementIndexes,omitempty"`  // Indexes of pseudo elements associated with this node in the `domNodes` array returned by `getSnapshot`, if any.
	LayoutNodeIndex       *int                        `json:"layoutNodeIndex,omitempty"`       // The index of the node's related layout tree node in the `layoutTreeNodes` array returned by `getSnapshot`, if any.
	DocumentURL           *string                     `json:"documentURL,omitempty"`           // Document URL that `Document` or `FrameOwner` node points to.
	BaseURL               *string                     `json:"baseURL,omitempty"`               // Base URL that `Document` or `FrameOwner` node uses for URL completion.
	ContentLanguage       *string                     `json:"contentLanguage,omitempty"`       // Only set for documents, contains the document's content language.
	DocumentEncoding      *string                     `json:"documentEncoding,omitempty"`      // Only set for documents, contains the document's character set encoding.
	PublicID              *string                     `json:"publicId,omitempty"`              // `DocumentType` node's publicId.
	SystemID              *string                     `json:"systemId,omitempty"`              // `DocumentType` node's systemId.
	FrameID               *page.FrameID               `json:"frameId,omitempty"`               // Frame ID for frame owner elements and also for the document node.
	ContentDocumentIndex  *int                        `json:"contentDocumentIndex,omitempty"`  // The index of a frame owner element's content document in the `domNodes` array returned by `getSnapshot`, if any.
	ImportedDocumentIndex *int                        `json:"importedDocumentIndex,omitempty"` // Index of the imported document's node of a link element in the `domNodes` array returned by `getSnapshot`, if any.
	TemplateContentIndex  *int                        `json:"templateContentIndex,omitempty"`  // Index of the content node of a template element in the `domNodes` array returned by `getSnapshot`.
	PseudoType            *dom.PseudoType             `json:"pseudoType,omitempty"`            // Type of a pseudo element node.
	ShadowRootType        *dom.ShadowRootType         `json:"shadowRootType,omitempty"`        // Shadow root type.
	IsClickable           *bool                       `json:"isClickable,omitempty"`           // Whether this DOM node responds to mouse clicks. This includes nodes that have had click event listeners attached via JavaScript as well as anchor tags that naturally navigate when clicked.
	EventListeners        []domdebugger.EventListener `json:"eventListeners,omitempty"`        // Details of the node's event listeners, if any.
	CurrentSourceURL      *string                     `json:"currentSourceURL,omitempty"`      // The selected url for nodes with a srcset attribute.
	OriginURL             *string                     `json:"originURL,omitempty"`             // The url of the script (if any) that generates this node.
}

DOMNode A Node in the DOM tree.

type DOMTreeSnapshot added in v0.18.5

type DOMTreeSnapshot struct {
	ParentIndex           []int               `json:"parentIndex,omitempty"`           // Parent node index.
	NodeType              []int               `json:"nodeType,omitempty"`              // `Node`'s nodeType.
	NodeName              []StringIndex       `json:"nodeName,omitempty"`              // `Node`'s nodeName.
	NodeValue             []StringIndex       `json:"nodeValue,omitempty"`             // `Node`'s nodeValue.
	BackendNodeID         []dom.BackendNodeID `json:"backendNodeId,omitempty"`         // `Node`'s id, corresponds to DOM.Node.backendNodeId.
	Attributes            []ArrayOfStrings    `json:"attributes,omitempty"`            // Attributes of an `Element` node. Flatten name, value pairs.
	LayoutNodeIndex       []int               `json:"layoutNodeIndex,omitempty"`       // The index of the node's related layout tree node in the `layoutTreeNodes` array returned by `captureSnapshot`, if any.
	TextValue             *RareStringData     `json:"textValue,omitempty"`             // Only set for textarea elements, contains the text value.
	InputValue            *RareStringData     `json:"inputValue,omitempty"`            // Only set for input elements, contains the input's associated text value.
	InputChecked          *RareBooleanData    `json:"inputChecked,omitempty"`          // Only set for radio and checkbox input elements, indicates if the element has been checked
	OptionSelected        *RareBooleanData    `json:"optionSelected,omitempty"`        // Only set for option elements, indicates if the element has been selected
	DocumentURL           *RareStringData     `json:"documentURL,omitempty"`           // Document URL that `Document` or `FrameOwner` node points to.
	BaseURL               *RareStringData     `json:"baseURL,omitempty"`               // Base URL that `Document` or `FrameOwner` node uses for URL completion.
	ContentLanguage       *RareStringData     `json:"contentLanguage,omitempty"`       // Only set for documents, contains the document's content language.
	DocumentEncoding      *RareStringData     `json:"documentEncoding,omitempty"`      // Only set for documents, contains the document's character set encoding.
	PublicID              *RareStringData     `json:"publicId,omitempty"`              // `DocumentType` node's publicId.
	SystemID              *RareStringData     `json:"systemId,omitempty"`              // `DocumentType` node's systemId.
	FrameID               *RareStringData     `json:"frameId,omitempty"`               // Frame ID for frame owner elements and also for the document node.
	ContentDocumentIndex  *RareIntegerData    `json:"contentDocumentIndex,omitempty"`  // The index of a frame owner element's content document in the `domNodes` array returned by `captureSnapshot`, if any.
	ImportedDocumentIndex *RareIntegerData    `json:"importedDocumentIndex,omitempty"` // Index of the imported document's node of a link element in the `domNodes` array returned by `captureSnapshot`, if any.
	TemplateContentIndex  *RareIntegerData    `json:"templateContentIndex,omitempty"`  // Index of the content node of a template element in the `domNodes` array returned by `captureSnapshot`.
	PseudoType            *RareStringData     `json:"pseudoType,omitempty"`            // Type of a pseudo element node.
	IsClickable           *RareBooleanData    `json:"isClickable,omitempty"`           // Whether this DOM node responds to mouse clicks. This includes nodes that have had click event listeners attached via JavaScript as well as anchor tags that naturally navigate when clicked.
	CurrentSourceURL      *RareStringData     `json:"currentSourceURL,omitempty"`      // The selected url for nodes with a srcset attribute.
	OriginURL             *RareStringData     `json:"originURL,omitempty"`             // The url of the script (if any) that generates this node.
}

DOMTreeSnapshot DOM tree snapshot.

type GetSnapshotArgs

type GetSnapshotArgs struct {
	ComputedStyleWhitelist     []string `json:"computedStyleWhitelist"`               // Whitelist of computed styles to return.
	IncludeEventListeners      *bool    `json:"includeEventListeners,omitempty"`      // Whether or not to retrieve details of DOM listeners (default false).
	IncludePaintOrder          *bool    `json:"includePaintOrder,omitempty"`          // Whether to determine and include the paint order index of LayoutTreeNodes (default false).
	IncludeUserAgentShadowTree *bool    `json:"includeUserAgentShadowTree,omitempty"` // Whether to include UA shadow tree in the snapshot (default false).
}

GetSnapshotArgs represents the arguments for GetSnapshot in the DOMSnapshot domain.

func NewGetSnapshotArgs

func NewGetSnapshotArgs(computedStyleWhitelist []string) *GetSnapshotArgs

NewGetSnapshotArgs initializes GetSnapshotArgs with the required arguments.

func (*GetSnapshotArgs) SetIncludeEventListeners added in v0.15.6

func (a *GetSnapshotArgs) SetIncludeEventListeners(includeEventListeners bool) *GetSnapshotArgs

SetIncludeEventListeners sets the IncludeEventListeners optional argument. Whether or not to retrieve details of DOM listeners (default false).

func (*GetSnapshotArgs) SetIncludePaintOrder added in v0.17.2

func (a *GetSnapshotArgs) SetIncludePaintOrder(includePaintOrder bool) *GetSnapshotArgs

SetIncludePaintOrder sets the IncludePaintOrder optional argument. Whether to determine and include the paint order index of LayoutTreeNodes (default false).

func (*GetSnapshotArgs) SetIncludeUserAgentShadowTree added in v0.18.1

func (a *GetSnapshotArgs) SetIncludeUserAgentShadowTree(includeUserAgentShadowTree bool) *GetSnapshotArgs

SetIncludeUserAgentShadowTree sets the IncludeUserAgentShadowTree optional argument. Whether to include UA shadow tree in the snapshot (default false).

type GetSnapshotReply

type GetSnapshotReply struct {
	DOMNodes        []DOMNode        `json:"domNodes"`        // The nodes in the DOM tree. The DOMNode at index 0 corresponds to the root document.
	LayoutTreeNodes []LayoutTreeNode `json:"layoutTreeNodes"` // The nodes in the layout tree.
	ComputedStyles  []ComputedStyle  `json:"computedStyles"`  // Whitelisted ComputedStyle properties for each node in the layout tree.
}

GetSnapshotReply represents the return values for GetSnapshot in the DOMSnapshot domain.

type InlineTextBox added in v0.14.2

type InlineTextBox struct {
	BoundingBox         dom.Rect `json:"boundingBox"`         // The absolute position bounding box.
	StartCharacterIndex int      `json:"startCharacterIndex"` // The starting index in characters, for this post layout textbox substring. Characters that would be represented as a surrogate pair in UTF-16 have length 2.
	NumCharacters       int      `json:"numCharacters"`       // The number of characters in this post layout textbox substring. Characters that would be represented as a surrogate pair in UTF-16 have length 2.
}

InlineTextBox Details of post layout rendered text positions. The exact layout should not be regarded as stable and may change between versions.

type LayoutTreeNode

type LayoutTreeNode struct {
	DOMNodeIndex    int             `json:"domNodeIndex"`              // The index of the related DOM node in the `domNodes` array returned by `getSnapshot`.
	BoundingBox     dom.Rect        `json:"boundingBox"`               // The absolute position bounding box.
	LayoutText      *string         `json:"layoutText,omitempty"`      // Contents of the LayoutText, if any.
	InlineTextNodes []InlineTextBox `json:"inlineTextNodes,omitempty"` // The post-layout inline text nodes, if any.
	StyleIndex      *int            `json:"styleIndex,omitempty"`      // Index into the `computedStyles` array returned by `getSnapshot`.
	PaintOrder      *int            `json:"paintOrder,omitempty"`      // Global paint order index, which is determined by the stacking order of the nodes. Nodes that are painted together will have the same index. Only provided if includePaintOrder in getSnapshot was true.
}

LayoutTreeNode Details of an element in the DOM tree with a LayoutObject.

type LayoutTreeSnapshot added in v0.18.5

type LayoutTreeSnapshot struct {
	NodeIndex []int            `json:"nodeIndex"` // The index of the related DOM node in the `domNodes` array returned by `getSnapshot`.
	Styles    []ArrayOfStrings `json:"styles"`    // Index into the `computedStyles` array returned by `captureSnapshot`.
	Bounds    []Rectangle      `json:"bounds"`    // The absolute position bounding box.
	Text      []StringIndex    `json:"text"`      // Contents of the LayoutText, if any.
	TextBoxes TextBoxSnapshot  `json:"textBoxes"` // The post-layout inline text nodes
}

LayoutTreeSnapshot Details of an element in the DOM tree with a LayoutObject.

type NameValue

type NameValue struct {
	Name  string `json:"name"`  // Attribute/property name.
	Value string `json:"value"` // Attribute/property value.
}

NameValue A name/value pair.

type RareBooleanData added in v0.18.5

type RareBooleanData struct {
	Index []int `json:"index"` // No description.
}

RareBooleanData

type RareIntegerData added in v0.18.5

type RareIntegerData struct {
	Index []int `json:"index"` // No description.
	Value []int `json:"value"` // No description.
}

RareIntegerData

type RareStringData added in v0.18.5

type RareStringData struct {
	Index []int         `json:"index"` // No description.
	Value []StringIndex `json:"value"` // No description.
}

RareStringData Data that is only present on rare nodes.

type Rectangle added in v0.18.5

type Rectangle []float64

Rectangle

type StringIndex added in v0.18.5

type StringIndex int

StringIndex Index of the string in the strings table.

type StylesSnapshot added in v0.18.5

type StylesSnapshot struct {
	Values []ArrayOfStrings `json:"values"` // Whitelisted ComputedStyle property values referenced by styleIndex.
}

StylesSnapshot Computed style snapshot.

type TextBoxSnapshot added in v0.18.5

type TextBoxSnapshot struct {
	LayoutIndex []int       `json:"layoutIndex"` // Intex of th elayout tree node that owns this box collection.
	Bounds      []Rectangle `json:"bounds"`      // The absolute position bounding box.
	Start       []int       `json:"start"`       // The starting index in characters, for this post layout textbox substring. Characters that would be represented as a surrogate pair in UTF-16 have length 2.
	Length      []int       `json:"length"`      // The number of characters in this post layout textbox substring. Characters that would be represented as a surrogate pair in UTF-16 have length 2.
}

TextBoxSnapshot Details of post layout rendered text positions. The exact layout should not be regarded as stable and may change between versions.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL