web

README

Venom - Executor Web

Navigate in a web application

Use case: You have a web application and you want to check some behaviours ? Venom allows you to navigate into it and execute actions.

Input

• Action (https://github.com/runabove/venom/tree/master/executors/web/types.go)
• Screenshot

name: TestSuite Web
testcases:
- name: TestCase Google search
  context:
    type: web
    width: 1920
    height: 1080
  steps:
  - action:
      navigate: https://www.google.fr
    assertions:
    - result.title ShouldEqual Google
    - result.url ShouldEqual https://www.google.fr
  - action:
      find: input[name="q"]
    assertions:
     - result.find ShouldEqual 1
  - action:
      fill:
      - find: input[name="q"]
        text: "venom runabove"
  - action:
      click: input[value="Recherche Google"]
    screenshot: googlesearch.jpg

Output

• result.url
• result.timeseconds
• result.timehuman
• result.title
• result.find

Documentation

Index

• Constants
• func New() venom.Executor
• type Action
• type Executor
  • func (Executor) Run(testCaseContext venom.TestCaseContext, l *log.Entry, step venom.TestStep) (venom.ExecutorResult, error)
• type Fill
• type Result

Constants

const Name = "web"

Name of executor

Functions

func New

func New() venom.Executor

New returns a new Executor

Types

type Action

type Action struct {
	Click    string `yaml:"search,omitempty"`
	Fill     []Fill `yaml:"fill,omitempty"`
	Find     string `yaml:"find,omitempty"`
	Navigate string `yaml:"find,omitempty"`
}

Action represents what can be done with web executor

type Executor

type Executor struct {
	Action     Action `json:"action,omitempty" yaml:"action"`
	Screenshot string `json:"screenshot,omitempty" yaml:"screenshot"`
}

Executor struct

func (Executor) Run

func (Executor) Run(testCaseContext venom.TestCaseContext, l *log.Entry, step venom.TestStep) (venom.ExecutorResult, error)

Run execute TestStep

type Fill

type Fill struct {
	Find string `yaml:"search,omitempty"`
	Text string `yaml:"text,omitempty"`
}

Fill represents informations needed to fill input/textarea

type Result

type Result struct {
	Executor    Executor `json:"executor,omitempty" yaml:"executor,omitempty"`
	Find        int      `json:"find,omitempty" yaml:"find,omitempty"`
	HTML        string   `json:"html,omitempty" yaml:"html,omitempty"`
	TimeSeconds float64  `json:"timeseconds,omitempty" yaml:"timeseconds,omitempty"`
	TimeHuman   string   `json:"timehuman,omitempty" yaml:"timehuman,omitempty"`
	Title       string   `json:"title,omitempty" yaml:"title,omitempty"`
	URL         string   `json:"url,omitempty" yaml:"url,omitempty"`
}

Result represents a step result