browsertest

Documentation

Overview

Package browsertest provides integration test helpers for our browser-based tests.

Index

• func LoginToUpstreamLDAP(t *testing.T, b *Browser, issuer, username, password string)
• func LoginToUpstreamOIDC(t *testing.T, b *Browser, upstream testlib.TestOIDCUpstream)
• func SubmitUpstreamLDAPLoginForm(t *testing.T, b *Browser, username string, password string)
• func WaitForUpstreamLDAPLoginPageWithError(t *testing.T, b *Browser, issuer string)
• type Browser
  • func OpenBrowser(t *testing.T) *Browser
  • func (b *Browser) AttrValueOfFirstMatch(t *testing.T, cssSelector string, attributeName string) string
  • func (b *Browser) ClickFirstMatch(t *testing.T, cssSelector string) string
  • func (b *Browser) FindConsoleEventWithTextMatching(consoleEventAPIType string, re *regexp.Regexp) (string, bool)
  • func (b *Browser) Navigate(t *testing.T, url string)
  • func (b *Browser) SendKeysToFirstMatch(t *testing.T, cssSelector string, runesToType string)
  • func (b *Browser) TextOfFirstMatch(t *testing.T, cssSelector string) string
  • func (b *Browser) Title(t *testing.T) string
  • func (b *Browser) WaitForURL(t *testing.T, regex *regexp.Regexp)
  • func (b *Browser) WaitForVisibleElements(t *testing.T, cssSelectors ...string)

Functions

func LoginToUpstreamLDAP

func LoginToUpstreamLDAP(t *testing.T, b *Browser, issuer, username, password string)

LoginToUpstreamLDAP expects the page to be redirected to the Supervisor's login UI for an LDAP/AD IDP. It knows how to enter the test username/password and submit the upstream login form.

func LoginToUpstreamOIDC

func LoginToUpstreamOIDC(t *testing.T, b *Browser, upstream testlib.TestOIDCUpstream)

LoginToUpstreamOIDC expects the page to be redirected to one of several known upstream IDPs. It knows how to enter the test username/password and submit the upstream login form.

func SubmitUpstreamLDAPLoginForm

func SubmitUpstreamLDAPLoginForm(t *testing.T, b *Browser, username string, password string)

func WaitForUpstreamLDAPLoginPageWithError

func WaitForUpstreamLDAPLoginPageWithError(t *testing.T, b *Browser, issuer string)

Types

type Browser

type Browser struct {
	// contains filtered or unexported fields
}

Browser abstracts the specific browser driver library that we use and provides an interface for integration tests to interact with the browser.

func OpenBrowser

func OpenBrowser(t *testing.T) *Browser

OpenBrowser opens a web browser as a subprocess and returns a Browser which allows further interactions with the browser. The subprocess will be cleaned up at the end of the test. Each call to OpenBrowser creates a new browser which does not share any cookies with other browsers from other calls.

func (*Browser) AttrValueOfFirstMatch

func (b *Browser) AttrValueOfFirstMatch(t *testing.T, cssSelector string, attributeName string) string

func (*Browser) ClickFirstMatch

func (b *Browser) ClickFirstMatch(t *testing.T, cssSelector string) string

func (*Browser) FindConsoleEventWithTextMatching

func (b *Browser) FindConsoleEventWithTextMatching(consoleEventAPIType string, re *regexp.Regexp) (string, bool)

FindConsoleEventWithTextMatching searches the browser's console that have been observed so far to find an event with an argument (converted to a string) that matches the provided regexp. consoleEventAPIType could be any of the console.funcName() names, e.g. "log", "info", "error", etc. It returns the first matching event argument value. It doesn't worry about optimizing the search speed because there should not be too many console events and because this just is a test helper.

func (*Browser) Navigate

func (b *Browser) Navigate(t *testing.T, url string)

func (*Browser) SendKeysToFirstMatch

func (b *Browser) SendKeysToFirstMatch(t *testing.T, cssSelector string, runesToType string)

func (*Browser) TextOfFirstMatch

func (b *Browser) TextOfFirstMatch(t *testing.T, cssSelector string) string

func (*Browser) Title

func (b *Browser) Title(t *testing.T) string

func (*Browser) WaitForURL

func (b *Browser) WaitForURL(t *testing.T, regex *regexp.Regexp)

WaitForURL expects the page to eventually navigate to a URL matching the specified pattern. It waits for this to occur and times out, failing the test, if it never does.

func (*Browser) WaitForVisibleElements

func (b *Browser) WaitForVisibleElements(t *testing.T, cssSelectors ...string)