package drivers import ( "context" "io" "github.com/MontFerret/ferret/pkg/runtime/collections" "github.com/MontFerret/ferret/pkg/runtime/core" "github.com/MontFerret/ferret/pkg/runtime/values" ) type ( // WaitEvent is an enum that represents what event is needed to wait for WaitEvent int // Node is an interface from which a number of DOM API object types inherit. // It allows those types to be treated similarly; // for example, inheriting the same set of methods, or being tested in the same way. HTMLNode interface { core.Value core.Iterable core.Getter core.Setter collections.Measurable io.Closer IsDetached() values.Boolean GetNodeType() values.Int GetNodeName() values.String GetChildNodes(ctx context.Context) core.Value GetChildNode(ctx context.Context, idx values.Int) core.Value QuerySelector(ctx context.Context, selector values.String) core.Value QuerySelectorAll(ctx context.Context, selector values.String) core.Value CountBySelector(ctx context.Context, selector values.String) values.Int ExistsBySelector(ctx context.Context, selector values.String) (values.Boolean, error) XPath(ctx context.Context, expression values.String) (core.Value, error) ClickBySelector(ctx context.Context, selector values.String) error ClickBySelectorAll(ctx context.Context, selector values.String) error } // HTMLElement is the most general base interface which most objects in a GetMainFrame implement. HTMLElement interface { HTMLNode GetInnerText(ctx context.Context) (values.String, error) SetInnerText(ctx context.Context, innerText values.String) error GetInnerHTML(ctx context.Context) (values.String, error) SetInnerHTML(ctx context.Context, innerHTML values.String) error GetValue(ctx context.Context) core.Value SetValue(ctx context.Context, value core.Value) error GetStyles(ctx context.Context) (*values.Object, error) GetStyle(ctx context.Context, name values.String) (core.Value, error) SetStyles(ctx context.Context, values *values.Object) error SetStyle(ctx context.Context, name values.String, value core.Value) error RemoveStyle(ctx context.Context, name ...values.String) error GetAttributes(ctx context.Context) *values.Object GetAttribute(ctx context.Context, name values.String) core.Value SetAttributes(ctx context.Context, values *values.Object) error SetAttribute(ctx context.Context, name, value values.String) error RemoveAttribute(ctx context.Context, name ...values.String) error GetInnerHTMLBySelector(ctx context.Context, selector values.String) (values.String, error) SetInnerHTMLBySelector(ctx context.Context, selector, innerHTML values.String) error GetInnerHTMLBySelectorAll(ctx context.Context, selector values.String) (*values.Array, error) GetInnerTextBySelector(ctx context.Context, selector values.String) (values.String, error) SetInnerTextBySelector(ctx context.Context, selector, innerText values.String) error GetInnerTextBySelectorAll(ctx context.Context, selector values.String) (*values.Array, error) Click(ctx context.Context) error Input(ctx context.Context, value core.Value, delay values.Int) error Select(ctx context.Context, value *values.Array) (*values.Array, error) ScrollIntoView(ctx context.Context) error Focus(ctx context.Context) error Hover(ctx context.Context) error WaitForAttribute(ctx context.Context, name values.String, value core.Value, when WaitEvent) error WaitForStyle(ctx context.Context, name values.String, value core.Value, when WaitEvent) error WaitForClass(ctx context.Context, class values.String, when WaitEvent) error } HTMLDocument interface { HTMLNode GetTitle() values.String GetElement() HTMLElement GetURL() values.String GetName() values.String GetParentDocument() HTMLDocument GetChildDocuments(ctx context.Context) (*values.Array, error) InputBySelector(ctx context.Context, selector values.String, value core.Value, delay values.Int) error SelectBySelector(ctx context.Context, selector values.String, value *values.Array) (*values.Array, error) ScrollTop(ctx context.Context) error ScrollBottom(ctx context.Context) error ScrollBySelector(ctx context.Context, selector values.String) error ScrollByXY(ctx context.Context, x, y values.Float) error FocusBySelector(ctx context.Context, selector values.String) error MoveMouseByXY(ctx context.Context, x, y values.Float) error MoveMouseBySelector(ctx context.Context, selector values.String) error WaitForElement(ctx context.Context, selector values.String, when WaitEvent) error WaitForAttributeBySelector(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error WaitForAttributeBySelectorAll(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error WaitForStyleBySelector(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error WaitForStyleBySelectorAll(ctx context.Context, selector, name values.String, value core.Value, when WaitEvent) error WaitForClassBySelector(ctx context.Context, selector, class values.String, when WaitEvent) error WaitForClassBySelectorAll(ctx context.Context, selector, class values.String, when WaitEvent) error } // HTMLPage interface represents any web page loaded in the browser // and serves as an entry point into the web page's content HTMLPage interface { core.Value core.Iterable core.Getter core.Setter collections.Measurable io.Closer IsClosed() values.Boolean GetURL() values.String GetMainFrame() HTMLDocument GetFrames(ctx context.Context) (*values.Array, error) GetFrame(ctx context.Context, idx values.Int) (core.Value, error) GetCookies(ctx context.Context) (*values.Array, error) SetCookies(ctx context.Context, cookies ...HTTPCookie) error DeleteCookies(ctx context.Context, cookies ...HTTPCookie) error PrintToPDF(ctx context.Context, params PDFParams) (values.Binary, error) CaptureScreenshot(ctx context.Context, params ScreenshotParams) (values.Binary, error) WaitForNavigation(ctx context.Context) error Navigate(ctx context.Context, url values.String) error NavigateBack(ctx context.Context, skip values.Int) (values.Boolean, error) NavigateForward(ctx context.Context, skip values.Int) (values.Boolean, error) } ) const ( // Event indicating to wait for value to appear WaitEventPresence = 0 // Event indicating to wait for value to disappear WaitEventAbsence = 1 )