# DO NOT EDIT THIS FILE!
|
#
|
# This file is generated from the CDP specification. If you need to make
|
# changes, edit the generator and regenerate all of the modules.
|
#
|
# CDP domain: CSS (experimental)
|
from __future__ import annotations
|
from .util import event_class, T_JSON_DICT
|
from dataclasses import dataclass
|
import enum
|
import typing
|
from . import dom
|
from . import page
|
|
|
class StyleSheetId(str):
|
def to_json(self) -> str:
|
return self
|
|
@classmethod
|
def from_json(cls, json: str) -> StyleSheetId:
|
return cls(json)
|
|
def __repr__(self):
|
return 'StyleSheetId({})'.format(super().__repr__())
|
|
|
class StyleSheetOrigin(enum.Enum):
|
'''
|
Stylesheet type: "injected" for stylesheets injected via extension, "user-agent" for user-agent
|
stylesheets, "inspector" for stylesheets created by the inspector (i.e. those holding the "via
|
inspector" rules), "regular" for regular stylesheets.
|
'''
|
INJECTED = "injected"
|
USER_AGENT = "user-agent"
|
INSPECTOR = "inspector"
|
REGULAR = "regular"
|
|
def to_json(self):
|
return self.value
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(json)
|
|
|
@dataclass
|
class PseudoElementMatches:
|
'''
|
CSS rule collection for a single pseudo style.
|
'''
|
#: Pseudo element type.
|
pseudo_type: dom.PseudoType
|
|
#: Matches of CSS rules applicable to the pseudo style.
|
matches: typing.List[RuleMatch]
|
|
def to_json(self):
|
json = dict()
|
json['pseudoType'] = self.pseudo_type.to_json()
|
json['matches'] = [i.to_json() for i in self.matches]
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
pseudo_type=dom.PseudoType.from_json(json['pseudoType']),
|
matches=[RuleMatch.from_json(i) for i in json['matches']],
|
)
|
|
|
@dataclass
|
class InheritedStyleEntry:
|
'''
|
Inherited CSS rule collection from ancestor node.
|
'''
|
#: Matches of CSS rules matching the ancestor node in the style inheritance chain.
|
matched_css_rules: typing.List[RuleMatch]
|
|
#: The ancestor node's inline style, if any, in the style inheritance chain.
|
inline_style: typing.Optional[CSSStyle] = None
|
|
def to_json(self):
|
json = dict()
|
json['matchedCSSRules'] = [i.to_json() for i in self.matched_css_rules]
|
if self.inline_style is not None:
|
json['inlineStyle'] = self.inline_style.to_json()
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
matched_css_rules=[RuleMatch.from_json(i) for i in json['matchedCSSRules']],
|
inline_style=CSSStyle.from_json(json['inlineStyle']) if 'inlineStyle' in json else None,
|
)
|
|
|
@dataclass
|
class RuleMatch:
|
'''
|
Match data for a CSS rule.
|
'''
|
#: CSS rule in the match.
|
rule: CSSRule
|
|
#: Matching selector indices in the rule's selectorList selectors (0-based).
|
matching_selectors: typing.List[int]
|
|
def to_json(self):
|
json = dict()
|
json['rule'] = self.rule.to_json()
|
json['matchingSelectors'] = [i for i in self.matching_selectors]
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
rule=CSSRule.from_json(json['rule']),
|
matching_selectors=[int(i) for i in json['matchingSelectors']],
|
)
|
|
|
@dataclass
|
class Value:
|
'''
|
Data for a simple selector (these are delimited by commas in a selector list).
|
'''
|
#: Value text.
|
text: str
|
|
#: Value range in the underlying resource (if available).
|
range_: typing.Optional[SourceRange] = None
|
|
def to_json(self):
|
json = dict()
|
json['text'] = self.text
|
if self.range_ is not None:
|
json['range'] = self.range_.to_json()
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
text=str(json['text']),
|
range_=SourceRange.from_json(json['range']) if 'range' in json else None,
|
)
|
|
|
@dataclass
|
class SelectorList:
|
'''
|
Selector list data.
|
'''
|
#: Selectors in the list.
|
selectors: typing.List[Value]
|
|
#: Rule selector text.
|
text: str
|
|
def to_json(self):
|
json = dict()
|
json['selectors'] = [i.to_json() for i in self.selectors]
|
json['text'] = self.text
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
selectors=[Value.from_json(i) for i in json['selectors']],
|
text=str(json['text']),
|
)
|
|
|
@dataclass
|
class CSSStyleSheetHeader:
|
'''
|
CSS stylesheet metainformation.
|
'''
|
#: The stylesheet identifier.
|
style_sheet_id: StyleSheetId
|
|
#: Owner frame identifier.
|
frame_id: page.FrameId
|
|
#: Stylesheet resource URL.
|
source_url: str
|
|
#: Stylesheet origin.
|
origin: StyleSheetOrigin
|
|
#: Stylesheet title.
|
title: str
|
|
#: Denotes whether the stylesheet is disabled.
|
disabled: bool
|
|
#: Whether this stylesheet is created for STYLE tag by parser. This flag is not set for
|
#: document.written STYLE tags.
|
is_inline: bool
|
|
#: Whether this stylesheet is mutable. Inline stylesheets become mutable
|
#: after they have been modified via CSSOM API.
|
#: <link> element's stylesheets are never mutable. Constructed stylesheets
|
#: (new CSSStyleSheet()) are mutable immediately after creation.
|
is_mutable: bool
|
|
#: Line offset of the stylesheet within the resource (zero based).
|
start_line: float
|
|
#: Column offset of the stylesheet within the resource (zero based).
|
start_column: float
|
|
#: Size of the content (in characters).
|
length: float
|
|
#: Line offset of the end of the stylesheet within the resource (zero based).
|
end_line: float
|
|
#: Column offset of the end of the stylesheet within the resource (zero based).
|
end_column: float
|
|
#: URL of source map associated with the stylesheet (if any).
|
source_map_url: typing.Optional[str] = None
|
|
#: The backend id for the owner node of the stylesheet.
|
owner_node: typing.Optional[dom.BackendNodeId] = None
|
|
#: Whether the sourceURL field value comes from the sourceURL comment.
|
has_source_url: typing.Optional[bool] = None
|
|
def to_json(self):
|
json = dict()
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
json['frameId'] = self.frame_id.to_json()
|
json['sourceURL'] = self.source_url
|
json['origin'] = self.origin.to_json()
|
json['title'] = self.title
|
json['disabled'] = self.disabled
|
json['isInline'] = self.is_inline
|
json['isMutable'] = self.is_mutable
|
json['startLine'] = self.start_line
|
json['startColumn'] = self.start_column
|
json['length'] = self.length
|
json['endLine'] = self.end_line
|
json['endColumn'] = self.end_column
|
if self.source_map_url is not None:
|
json['sourceMapURL'] = self.source_map_url
|
if self.owner_node is not None:
|
json['ownerNode'] = self.owner_node.to_json()
|
if self.has_source_url is not None:
|
json['hasSourceURL'] = self.has_source_url
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']),
|
frame_id=page.FrameId.from_json(json['frameId']),
|
source_url=str(json['sourceURL']),
|
origin=StyleSheetOrigin.from_json(json['origin']),
|
title=str(json['title']),
|
disabled=bool(json['disabled']),
|
is_inline=bool(json['isInline']),
|
is_mutable=bool(json['isMutable']),
|
start_line=float(json['startLine']),
|
start_column=float(json['startColumn']),
|
length=float(json['length']),
|
end_line=float(json['endLine']),
|
end_column=float(json['endColumn']),
|
source_map_url=str(json['sourceMapURL']) if 'sourceMapURL' in json else None,
|
owner_node=dom.BackendNodeId.from_json(json['ownerNode']) if 'ownerNode' in json else None,
|
has_source_url=bool(json['hasSourceURL']) if 'hasSourceURL' in json else None,
|
)
|
|
|
@dataclass
|
class CSSRule:
|
'''
|
CSS rule representation.
|
'''
|
#: Rule selector data.
|
selector_list: SelectorList
|
|
#: Parent stylesheet's origin.
|
origin: StyleSheetOrigin
|
|
#: Associated style declaration.
|
style: CSSStyle
|
|
#: The css style sheet identifier (absent for user agent stylesheet and user-specified
|
#: stylesheet rules) this rule came from.
|
style_sheet_id: typing.Optional[StyleSheetId] = None
|
|
#: Media list array (for rules involving media queries). The array enumerates media queries
|
#: starting with the innermost one, going outwards.
|
media: typing.Optional[typing.List[CSSMedia]] = None
|
|
def to_json(self):
|
json = dict()
|
json['selectorList'] = self.selector_list.to_json()
|
json['origin'] = self.origin.to_json()
|
json['style'] = self.style.to_json()
|
if self.style_sheet_id is not None:
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
if self.media is not None:
|
json['media'] = [i.to_json() for i in self.media]
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
selector_list=SelectorList.from_json(json['selectorList']),
|
origin=StyleSheetOrigin.from_json(json['origin']),
|
style=CSSStyle.from_json(json['style']),
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']) if 'styleSheetId' in json else None,
|
media=[CSSMedia.from_json(i) for i in json['media']] if 'media' in json else None,
|
)
|
|
|
@dataclass
|
class RuleUsage:
|
'''
|
CSS coverage information.
|
'''
|
#: The css style sheet identifier (absent for user agent stylesheet and user-specified
|
#: stylesheet rules) this rule came from.
|
style_sheet_id: StyleSheetId
|
|
#: Offset of the start of the rule (including selector) from the beginning of the stylesheet.
|
start_offset: float
|
|
#: Offset of the end of the rule body from the beginning of the stylesheet.
|
end_offset: float
|
|
#: Indicates whether the rule was actually used by some element in the page.
|
used: bool
|
|
def to_json(self):
|
json = dict()
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
json['startOffset'] = self.start_offset
|
json['endOffset'] = self.end_offset
|
json['used'] = self.used
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']),
|
start_offset=float(json['startOffset']),
|
end_offset=float(json['endOffset']),
|
used=bool(json['used']),
|
)
|
|
|
@dataclass
|
class SourceRange:
|
'''
|
Text range within a resource. All numbers are zero-based.
|
'''
|
#: Start line of range.
|
start_line: int
|
|
#: Start column of range (inclusive).
|
start_column: int
|
|
#: End line of range
|
end_line: int
|
|
#: End column of range (exclusive).
|
end_column: int
|
|
def to_json(self):
|
json = dict()
|
json['startLine'] = self.start_line
|
json['startColumn'] = self.start_column
|
json['endLine'] = self.end_line
|
json['endColumn'] = self.end_column
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
start_line=int(json['startLine']),
|
start_column=int(json['startColumn']),
|
end_line=int(json['endLine']),
|
end_column=int(json['endColumn']),
|
)
|
|
|
@dataclass
|
class ShorthandEntry:
|
#: Shorthand name.
|
name: str
|
|
#: Shorthand value.
|
value: str
|
|
#: Whether the property has "!important" annotation (implies ``false`` if absent).
|
important: typing.Optional[bool] = None
|
|
def to_json(self):
|
json = dict()
|
json['name'] = self.name
|
json['value'] = self.value
|
if self.important is not None:
|
json['important'] = self.important
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
name=str(json['name']),
|
value=str(json['value']),
|
important=bool(json['important']) if 'important' in json else None,
|
)
|
|
|
@dataclass
|
class CSSComputedStyleProperty:
|
#: Computed style property name.
|
name: str
|
|
#: Computed style property value.
|
value: str
|
|
def to_json(self):
|
json = dict()
|
json['name'] = self.name
|
json['value'] = self.value
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
name=str(json['name']),
|
value=str(json['value']),
|
)
|
|
|
@dataclass
|
class CSSStyle:
|
'''
|
CSS style representation.
|
'''
|
#: CSS properties in the style.
|
css_properties: typing.List[CSSProperty]
|
|
#: Computed values for all shorthands found in the style.
|
shorthand_entries: typing.List[ShorthandEntry]
|
|
#: The css style sheet identifier (absent for user agent stylesheet and user-specified
|
#: stylesheet rules) this rule came from.
|
style_sheet_id: typing.Optional[StyleSheetId] = None
|
|
#: Style declaration text (if available).
|
css_text: typing.Optional[str] = None
|
|
#: Style declaration range in the enclosing stylesheet (if available).
|
range_: typing.Optional[SourceRange] = None
|
|
def to_json(self):
|
json = dict()
|
json['cssProperties'] = [i.to_json() for i in self.css_properties]
|
json['shorthandEntries'] = [i.to_json() for i in self.shorthand_entries]
|
if self.style_sheet_id is not None:
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
if self.css_text is not None:
|
json['cssText'] = self.css_text
|
if self.range_ is not None:
|
json['range'] = self.range_.to_json()
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
css_properties=[CSSProperty.from_json(i) for i in json['cssProperties']],
|
shorthand_entries=[ShorthandEntry.from_json(i) for i in json['shorthandEntries']],
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']) if 'styleSheetId' in json else None,
|
css_text=str(json['cssText']) if 'cssText' in json else None,
|
range_=SourceRange.from_json(json['range']) if 'range' in json else None,
|
)
|
|
|
@dataclass
|
class CSSProperty:
|
'''
|
CSS property declaration data.
|
'''
|
#: The property name.
|
name: str
|
|
#: The property value.
|
value: str
|
|
#: Whether the property has "!important" annotation (implies ``false`` if absent).
|
important: typing.Optional[bool] = None
|
|
#: Whether the property is implicit (implies ``false`` if absent).
|
implicit: typing.Optional[bool] = None
|
|
#: The full property text as specified in the style.
|
text: typing.Optional[str] = None
|
|
#: Whether the property is understood by the browser (implies ``true`` if absent).
|
parsed_ok: typing.Optional[bool] = None
|
|
#: Whether the property is disabled by the user (present for source-based properties only).
|
disabled: typing.Optional[bool] = None
|
|
#: The entire property range in the enclosing style declaration (if available).
|
range_: typing.Optional[SourceRange] = None
|
|
def to_json(self):
|
json = dict()
|
json['name'] = self.name
|
json['value'] = self.value
|
if self.important is not None:
|
json['important'] = self.important
|
if self.implicit is not None:
|
json['implicit'] = self.implicit
|
if self.text is not None:
|
json['text'] = self.text
|
if self.parsed_ok is not None:
|
json['parsedOk'] = self.parsed_ok
|
if self.disabled is not None:
|
json['disabled'] = self.disabled
|
if self.range_ is not None:
|
json['range'] = self.range_.to_json()
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
name=str(json['name']),
|
value=str(json['value']),
|
important=bool(json['important']) if 'important' in json else None,
|
implicit=bool(json['implicit']) if 'implicit' in json else None,
|
text=str(json['text']) if 'text' in json else None,
|
parsed_ok=bool(json['parsedOk']) if 'parsedOk' in json else None,
|
disabled=bool(json['disabled']) if 'disabled' in json else None,
|
range_=SourceRange.from_json(json['range']) if 'range' in json else None,
|
)
|
|
|
@dataclass
|
class CSSMedia:
|
'''
|
CSS media rule descriptor.
|
'''
|
#: Media query text.
|
text: str
|
|
#: Source of the media query: "mediaRule" if specified by a @media rule, "importRule" if
|
#: specified by an @import rule, "linkedSheet" if specified by a "media" attribute in a linked
|
#: stylesheet's LINK tag, "inlineSheet" if specified by a "media" attribute in an inline
|
#: stylesheet's STYLE tag.
|
source: str
|
|
#: URL of the document containing the media query description.
|
source_url: typing.Optional[str] = None
|
|
#: The associated rule (@media or @import) header range in the enclosing stylesheet (if
|
#: available).
|
range_: typing.Optional[SourceRange] = None
|
|
#: Identifier of the stylesheet containing this object (if exists).
|
style_sheet_id: typing.Optional[StyleSheetId] = None
|
|
#: Array of media queries.
|
media_list: typing.Optional[typing.List[MediaQuery]] = None
|
|
def to_json(self):
|
json = dict()
|
json['text'] = self.text
|
json['source'] = self.source
|
if self.source_url is not None:
|
json['sourceURL'] = self.source_url
|
if self.range_ is not None:
|
json['range'] = self.range_.to_json()
|
if self.style_sheet_id is not None:
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
if self.media_list is not None:
|
json['mediaList'] = [i.to_json() for i in self.media_list]
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
text=str(json['text']),
|
source=str(json['source']),
|
source_url=str(json['sourceURL']) if 'sourceURL' in json else None,
|
range_=SourceRange.from_json(json['range']) if 'range' in json else None,
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']) if 'styleSheetId' in json else None,
|
media_list=[MediaQuery.from_json(i) for i in json['mediaList']] if 'mediaList' in json else None,
|
)
|
|
|
@dataclass
|
class MediaQuery:
|
'''
|
Media query descriptor.
|
'''
|
#: Array of media query expressions.
|
expressions: typing.List[MediaQueryExpression]
|
|
#: Whether the media query condition is satisfied.
|
active: bool
|
|
def to_json(self):
|
json = dict()
|
json['expressions'] = [i.to_json() for i in self.expressions]
|
json['active'] = self.active
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
expressions=[MediaQueryExpression.from_json(i) for i in json['expressions']],
|
active=bool(json['active']),
|
)
|
|
|
@dataclass
|
class MediaQueryExpression:
|
'''
|
Media query expression descriptor.
|
'''
|
#: Media query expression value.
|
value: float
|
|
#: Media query expression units.
|
unit: str
|
|
#: Media query expression feature.
|
feature: str
|
|
#: The associated range of the value text in the enclosing stylesheet (if available).
|
value_range: typing.Optional[SourceRange] = None
|
|
#: Computed length of media query expression (if applicable).
|
computed_length: typing.Optional[float] = None
|
|
def to_json(self):
|
json = dict()
|
json['value'] = self.value
|
json['unit'] = self.unit
|
json['feature'] = self.feature
|
if self.value_range is not None:
|
json['valueRange'] = self.value_range.to_json()
|
if self.computed_length is not None:
|
json['computedLength'] = self.computed_length
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
value=float(json['value']),
|
unit=str(json['unit']),
|
feature=str(json['feature']),
|
value_range=SourceRange.from_json(json['valueRange']) if 'valueRange' in json else None,
|
computed_length=float(json['computedLength']) if 'computedLength' in json else None,
|
)
|
|
|
@dataclass
|
class PlatformFontUsage:
|
'''
|
Information about amount of glyphs that were rendered with given font.
|
'''
|
#: Font's family name reported by platform.
|
family_name: str
|
|
#: Indicates if the font was downloaded or resolved locally.
|
is_custom_font: bool
|
|
#: Amount of glyphs that were rendered with this font.
|
glyph_count: float
|
|
def to_json(self):
|
json = dict()
|
json['familyName'] = self.family_name
|
json['isCustomFont'] = self.is_custom_font
|
json['glyphCount'] = self.glyph_count
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
family_name=str(json['familyName']),
|
is_custom_font=bool(json['isCustomFont']),
|
glyph_count=float(json['glyphCount']),
|
)
|
|
|
@dataclass
|
class FontFace:
|
'''
|
Properties of a web font: https://www.w3.org/TR/2008/REC-CSS2-20080411/fonts.html#font-descriptions
|
'''
|
#: The font-family.
|
font_family: str
|
|
#: The font-style.
|
font_style: str
|
|
#: The font-variant.
|
font_variant: str
|
|
#: The font-weight.
|
font_weight: str
|
|
#: The font-stretch.
|
font_stretch: str
|
|
#: The unicode-range.
|
unicode_range: str
|
|
#: The src.
|
src: str
|
|
#: The resolved platform font family
|
platform_font_family: str
|
|
def to_json(self):
|
json = dict()
|
json['fontFamily'] = self.font_family
|
json['fontStyle'] = self.font_style
|
json['fontVariant'] = self.font_variant
|
json['fontWeight'] = self.font_weight
|
json['fontStretch'] = self.font_stretch
|
json['unicodeRange'] = self.unicode_range
|
json['src'] = self.src
|
json['platformFontFamily'] = self.platform_font_family
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
font_family=str(json['fontFamily']),
|
font_style=str(json['fontStyle']),
|
font_variant=str(json['fontVariant']),
|
font_weight=str(json['fontWeight']),
|
font_stretch=str(json['fontStretch']),
|
unicode_range=str(json['unicodeRange']),
|
src=str(json['src']),
|
platform_font_family=str(json['platformFontFamily']),
|
)
|
|
|
@dataclass
|
class CSSKeyframesRule:
|
'''
|
CSS keyframes rule representation.
|
'''
|
#: Animation name.
|
animation_name: Value
|
|
#: List of keyframes.
|
keyframes: typing.List[CSSKeyframeRule]
|
|
def to_json(self):
|
json = dict()
|
json['animationName'] = self.animation_name.to_json()
|
json['keyframes'] = [i.to_json() for i in self.keyframes]
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
animation_name=Value.from_json(json['animationName']),
|
keyframes=[CSSKeyframeRule.from_json(i) for i in json['keyframes']],
|
)
|
|
|
@dataclass
|
class CSSKeyframeRule:
|
'''
|
CSS keyframe rule representation.
|
'''
|
#: Parent stylesheet's origin.
|
origin: StyleSheetOrigin
|
|
#: Associated key text.
|
key_text: Value
|
|
#: Associated style declaration.
|
style: CSSStyle
|
|
#: The css style sheet identifier (absent for user agent stylesheet and user-specified
|
#: stylesheet rules) this rule came from.
|
style_sheet_id: typing.Optional[StyleSheetId] = None
|
|
def to_json(self):
|
json = dict()
|
json['origin'] = self.origin.to_json()
|
json['keyText'] = self.key_text.to_json()
|
json['style'] = self.style.to_json()
|
if self.style_sheet_id is not None:
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
origin=StyleSheetOrigin.from_json(json['origin']),
|
key_text=Value.from_json(json['keyText']),
|
style=CSSStyle.from_json(json['style']),
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']) if 'styleSheetId' in json else None,
|
)
|
|
|
@dataclass
|
class StyleDeclarationEdit:
|
'''
|
A descriptor of operation to mutate style declaration text.
|
'''
|
#: The css style sheet identifier.
|
style_sheet_id: StyleSheetId
|
|
#: The range of the style text in the enclosing stylesheet.
|
range_: SourceRange
|
|
#: New style text.
|
text: str
|
|
def to_json(self):
|
json = dict()
|
json['styleSheetId'] = self.style_sheet_id.to_json()
|
json['range'] = self.range_.to_json()
|
json['text'] = self.text
|
return json
|
|
@classmethod
|
def from_json(cls, json):
|
return cls(
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId']),
|
range_=SourceRange.from_json(json['range']),
|
text=str(json['text']),
|
)
|
|
|
def add_rule(
|
style_sheet_id: StyleSheetId,
|
rule_text: str,
|
location: SourceRange
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,CSSRule]:
|
'''
|
Inserts a new rule with the given ``ruleText`` in a stylesheet with given ``styleSheetId``, at the
|
position specified by ``location``.
|
|
:param style_sheet_id: The css style sheet identifier where a new rule should be inserted.
|
:param rule_text: The text of a new rule.
|
:param location: Text position of a new rule in the target style sheet.
|
:returns: The newly created rule.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
params['ruleText'] = rule_text
|
params['location'] = location.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.addRule',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return CSSRule.from_json(json['rule'])
|
|
|
def collect_class_names(
|
style_sheet_id: StyleSheetId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[str]]:
|
'''
|
Returns all class names from specified stylesheet.
|
|
:param style_sheet_id:
|
:returns: Class name list.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.collectClassNames',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return [str(i) for i in json['classNames']]
|
|
|
def create_style_sheet(
|
frame_id: page.FrameId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,StyleSheetId]:
|
'''
|
Creates a new special "via-inspector" stylesheet in the frame with given ``frameId``.
|
|
:param frame_id: Identifier of the frame where "via-inspector" stylesheet should be created.
|
:returns: Identifier of the created "via-inspector" stylesheet.
|
'''
|
params: T_JSON_DICT = dict()
|
params['frameId'] = frame_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.createStyleSheet',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return StyleSheetId.from_json(json['styleSheetId'])
|
|
|
def disable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
|
'''
|
Disables the CSS agent for the given page.
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.disable',
|
}
|
json = yield cmd_dict
|
|
|
def enable() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
|
'''
|
Enables the CSS agent for the given page. Clients should not assume that the CSS agent has been
|
enabled until the result of this command is received.
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.enable',
|
}
|
json = yield cmd_dict
|
|
|
def force_pseudo_state(
|
node_id: dom.NodeId,
|
forced_pseudo_classes: typing.List[str]
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
|
'''
|
Ensures that the given node will have specified pseudo-classes whenever its style is computed by
|
the browser.
|
|
:param node_id: The element id for which to force the pseudo state.
|
:param forced_pseudo_classes: Element pseudo classes to force when computing the element's style.
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
params['forcedPseudoClasses'] = [i for i in forced_pseudo_classes]
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.forcePseudoState',
|
'params': params,
|
}
|
json = yield cmd_dict
|
|
|
def get_background_colors(
|
node_id: dom.NodeId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.Tuple[typing.Optional[typing.List[str]], typing.Optional[str], typing.Optional[str]]]:
|
'''
|
:param node_id: Id of the node to get background colors for.
|
:returns: A tuple with the following items:
|
|
0. **backgroundColors** - *(Optional)* The range of background colors behind this element, if it contains any visible text. If no visible text is present, this will be undefined. In the case of a flat background color, this will consist of simply that color. In the case of a gradient, this will consist of each of the color stops. For anything more complicated, this will be an empty array. Images will be ignored (as if the image had failed to load).
|
1. **computedFontSize** - *(Optional)* The computed font size for this node, as a CSS computed value string (e.g. '12px').
|
2. **computedFontWeight** - *(Optional)* The computed font weight for this node, as a CSS computed value string (e.g. 'normal' or '100').
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getBackgroundColors',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return (
|
[str(i) for i in json['backgroundColors']] if 'backgroundColors' in json else None,
|
str(json['computedFontSize']) if 'computedFontSize' in json else None,
|
str(json['computedFontWeight']) if 'computedFontWeight' in json else None
|
)
|
|
|
def get_computed_style_for_node(
|
node_id: dom.NodeId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[CSSComputedStyleProperty]]:
|
'''
|
Returns the computed style for a DOM node identified by ``nodeId``.
|
|
:param node_id:
|
:returns: Computed style for the specified DOM node.
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getComputedStyleForNode',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return [CSSComputedStyleProperty.from_json(i) for i in json['computedStyle']]
|
|
|
def get_inline_styles_for_node(
|
node_id: dom.NodeId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.Tuple[typing.Optional[CSSStyle], typing.Optional[CSSStyle]]]:
|
'''
|
Returns the styles defined inline (explicitly in the "style" attribute and implicitly, using DOM
|
attributes) for a DOM node identified by ``nodeId``.
|
|
:param node_id:
|
:returns: A tuple with the following items:
|
|
0. **inlineStyle** - *(Optional)* Inline style for the specified DOM node.
|
1. **attributesStyle** - *(Optional)* Attribute-defined element style (e.g. resulting from "width=20 height=100%").
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getInlineStylesForNode',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return (
|
CSSStyle.from_json(json['inlineStyle']) if 'inlineStyle' in json else None,
|
CSSStyle.from_json(json['attributesStyle']) if 'attributesStyle' in json else None
|
)
|
|
|
def get_matched_styles_for_node(
|
node_id: dom.NodeId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.Tuple[typing.Optional[CSSStyle], typing.Optional[CSSStyle], typing.Optional[typing.List[RuleMatch]], typing.Optional[typing.List[PseudoElementMatches]], typing.Optional[typing.List[InheritedStyleEntry]], typing.Optional[typing.List[CSSKeyframesRule]]]]:
|
'''
|
Returns requested styles for a DOM node identified by ``nodeId``.
|
|
:param node_id:
|
:returns: A tuple with the following items:
|
|
0. **inlineStyle** - *(Optional)* Inline style for the specified DOM node.
|
1. **attributesStyle** - *(Optional)* Attribute-defined element style (e.g. resulting from "width=20 height=100%").
|
2. **matchedCSSRules** - *(Optional)* CSS rules matching this node, from all applicable stylesheets.
|
3. **pseudoElements** - *(Optional)* Pseudo style matches for this node.
|
4. **inherited** - *(Optional)* A chain of inherited styles (from the immediate node parent up to the DOM tree root).
|
5. **cssKeyframesRules** - *(Optional)* A list of CSS keyframed animations matching this node.
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getMatchedStylesForNode',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return (
|
CSSStyle.from_json(json['inlineStyle']) if 'inlineStyle' in json else None,
|
CSSStyle.from_json(json['attributesStyle']) if 'attributesStyle' in json else None,
|
[RuleMatch.from_json(i) for i in json['matchedCSSRules']] if 'matchedCSSRules' in json else None,
|
[PseudoElementMatches.from_json(i) for i in json['pseudoElements']] if 'pseudoElements' in json else None,
|
[InheritedStyleEntry.from_json(i) for i in json['inherited']] if 'inherited' in json else None,
|
[CSSKeyframesRule.from_json(i) for i in json['cssKeyframesRules']] if 'cssKeyframesRules' in json else None
|
)
|
|
|
def get_media_queries() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[CSSMedia]]:
|
'''
|
Returns all media queries parsed by the rendering engine.
|
|
:returns:
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getMediaQueries',
|
}
|
json = yield cmd_dict
|
return [CSSMedia.from_json(i) for i in json['medias']]
|
|
|
def get_platform_fonts_for_node(
|
node_id: dom.NodeId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[PlatformFontUsage]]:
|
'''
|
Requests information about platform fonts which we used to render child TextNodes in the given
|
node.
|
|
:param node_id:
|
:returns: Usage statistics for every employed platform font.
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getPlatformFontsForNode',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return [PlatformFontUsage.from_json(i) for i in json['fonts']]
|
|
|
def get_style_sheet_text(
|
style_sheet_id: StyleSheetId
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,str]:
|
'''
|
Returns the current textual content for a stylesheet.
|
|
:param style_sheet_id:
|
:returns: The stylesheet text.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.getStyleSheetText',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return str(json['text'])
|
|
|
def set_effective_property_value_for_node(
|
node_id: dom.NodeId,
|
property_name: str,
|
value: str
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
|
'''
|
Find a rule with the given active property for the given node and set the new value for this
|
property
|
|
:param node_id: The element id for which to set property.
|
:param property_name:
|
:param value:
|
'''
|
params: T_JSON_DICT = dict()
|
params['nodeId'] = node_id.to_json()
|
params['propertyName'] = property_name
|
params['value'] = value
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setEffectivePropertyValueForNode',
|
'params': params,
|
}
|
json = yield cmd_dict
|
|
|
def set_keyframe_key(
|
style_sheet_id: StyleSheetId,
|
range_: SourceRange,
|
key_text: str
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,Value]:
|
'''
|
Modifies the keyframe rule key text.
|
|
:param style_sheet_id:
|
:param range_:
|
:param key_text:
|
:returns: The resulting key text after modification.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
params['range'] = range_.to_json()
|
params['keyText'] = key_text
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setKeyframeKey',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return Value.from_json(json['keyText'])
|
|
|
def set_media_text(
|
style_sheet_id: StyleSheetId,
|
range_: SourceRange,
|
text: str
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,CSSMedia]:
|
'''
|
Modifies the rule selector.
|
|
:param style_sheet_id:
|
:param range_:
|
:param text:
|
:returns: The resulting CSS media rule after modification.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
params['range'] = range_.to_json()
|
params['text'] = text
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setMediaText',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return CSSMedia.from_json(json['media'])
|
|
|
def set_rule_selector(
|
style_sheet_id: StyleSheetId,
|
range_: SourceRange,
|
selector: str
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,SelectorList]:
|
'''
|
Modifies the rule selector.
|
|
:param style_sheet_id:
|
:param range_:
|
:param selector:
|
:returns: The resulting selector list after modification.
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
params['range'] = range_.to_json()
|
params['selector'] = selector
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setRuleSelector',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return SelectorList.from_json(json['selectorList'])
|
|
|
def set_style_sheet_text(
|
style_sheet_id: StyleSheetId,
|
text: str
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.Optional[str]]:
|
'''
|
Sets the new stylesheet text.
|
|
:param style_sheet_id:
|
:param text:
|
:returns: *(Optional)* URL of source map associated with script (if any).
|
'''
|
params: T_JSON_DICT = dict()
|
params['styleSheetId'] = style_sheet_id.to_json()
|
params['text'] = text
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setStyleSheetText',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return str(json['sourceMapURL']) if 'sourceMapURL' in json else None
|
|
|
def set_style_texts(
|
edits: typing.List[StyleDeclarationEdit]
|
) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[CSSStyle]]:
|
'''
|
Applies specified style edits one after another in the given order.
|
|
:param edits:
|
:returns: The resulting styles after modification.
|
'''
|
params: T_JSON_DICT = dict()
|
params['edits'] = [i.to_json() for i in edits]
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.setStyleTexts',
|
'params': params,
|
}
|
json = yield cmd_dict
|
return [CSSStyle.from_json(i) for i in json['styles']]
|
|
|
def start_rule_usage_tracking() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,None]:
|
'''
|
Enables the selector recording.
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.startRuleUsageTracking',
|
}
|
json = yield cmd_dict
|
|
|
def stop_rule_usage_tracking() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[RuleUsage]]:
|
'''
|
Stop tracking rule usage and return the list of rules that were used since last call to
|
``takeCoverageDelta`` (or since start of coverage instrumentation)
|
|
:returns:
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.stopRuleUsageTracking',
|
}
|
json = yield cmd_dict
|
return [RuleUsage.from_json(i) for i in json['ruleUsage']]
|
|
|
def take_coverage_delta() -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.Tuple[typing.List[RuleUsage], float]]:
|
'''
|
Obtain list of rules that became used since last call to this method (or since start of coverage
|
instrumentation)
|
|
:returns: A tuple with the following items:
|
|
0. **coverage** -
|
1. **timestamp** - Monotonically increasing time, in seconds.
|
'''
|
cmd_dict: T_JSON_DICT = {
|
'method': 'CSS.takeCoverageDelta',
|
}
|
json = yield cmd_dict
|
return (
|
[RuleUsage.from_json(i) for i in json['coverage']],
|
float(json['timestamp'])
|
)
|
|
|
@event_class('CSS.fontsUpdated')
|
@dataclass
|
class FontsUpdated:
|
'''
|
Fires whenever a web font is updated. A non-empty font parameter indicates a successfully loaded
|
web font
|
'''
|
#: The web font that has loaded.
|
font: typing.Optional[FontFace]
|
|
@classmethod
|
def from_json(cls, json: T_JSON_DICT) -> FontsUpdated:
|
return cls(
|
font=FontFace.from_json(json['font']) if 'font' in json else None
|
)
|
|
|
@event_class('CSS.mediaQueryResultChanged')
|
@dataclass
|
class MediaQueryResultChanged:
|
'''
|
Fires whenever a MediaQuery result changes (for example, after a browser window has been
|
resized.) The current implementation considers only viewport-dependent media features.
|
'''
|
|
|
@classmethod
|
def from_json(cls, json: T_JSON_DICT) -> MediaQueryResultChanged:
|
return cls(
|
|
)
|
|
|
@event_class('CSS.styleSheetAdded')
|
@dataclass
|
class StyleSheetAdded:
|
'''
|
Fired whenever an active document stylesheet is added.
|
'''
|
#: Added stylesheet metainfo.
|
header: CSSStyleSheetHeader
|
|
@classmethod
|
def from_json(cls, json: T_JSON_DICT) -> StyleSheetAdded:
|
return cls(
|
header=CSSStyleSheetHeader.from_json(json['header'])
|
)
|
|
|
@event_class('CSS.styleSheetChanged')
|
@dataclass
|
class StyleSheetChanged:
|
'''
|
Fired whenever a stylesheet is changed as a result of the client operation.
|
'''
|
style_sheet_id: StyleSheetId
|
|
@classmethod
|
def from_json(cls, json: T_JSON_DICT) -> StyleSheetChanged:
|
return cls(
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId'])
|
)
|
|
|
@event_class('CSS.styleSheetRemoved')
|
@dataclass
|
class StyleSheetRemoved:
|
'''
|
Fired whenever an active document stylesheet is removed.
|
'''
|
#: Identifier of the removed stylesheet.
|
style_sheet_id: StyleSheetId
|
|
@classmethod
|
def from_json(cls, json: T_JSON_DICT) -> StyleSheetRemoved:
|
return cls(
|
style_sheet_id=StyleSheetId.from_json(json['styleSheetId'])
|
)
|
