Expand description
Drives a built Router without a socket, carrying cookies, CSRF token, and
tenant, and reads values back out of its responses.
Structs§
- Bell
- The bell a panel page renders in its topbar.
- Bell
Notification - One notification the bell’s sheet lists.
- Cell
Edit - One cell editing its field in place: a form posting the field alone to the record’s edit route.
- Chart
Data - One chart, as its data table reads.
- Chart
Series - One series of a
ChartData. - Create
Option Link - A creatable choice’s link: the select it creates a record for, and the create page it opens.
- Detail
Entry - One entry of a detail page.
- Disabled
Action - A custom action whose button shows disabled, as the record’s state refuses it.
- Empty
Table - Why a table rendered no rows, and the links it offers out of that state.
- Fake
Account - An account at a
FakeProvider: what the ID token it issues says. - Fake
Provider - An OpenID Connect provider serving its discovery document and token endpoint on a loopback
port, which a panel’s
OidcProviderreaches as it would a real one. - Filter
Option - One
<option>of a filter select, or one checkbox of a filter checklist. - Group
- One group of a grouped table: its header’s label and the rows under it on this page.
- Ignored
Filter - A requested filter the table did not apply.
- Impersonation
Banner - The banner over a page a user reads while acting as another.
- Import
Error - One value an import refused.
- Language
Choice - One locale the shell’s language menu offers.
- NavGroup
- One labelled group of the sidebar: its label and the
hrefof each entry it lists. - Page
Filter Bar - A page’s filter bar.
- Picker
Column - One toggleable column the column picker offers.
- Record
NavLink - One tab of a record’s navigation.
- Record
Table Data - One record table, as its markup reads.
- Reply
- A response with its body read, keyed by the form’s field enum
Kfor the queries over its form. - Resource
Client - Requests to
Rin the panelTestClient::panelnames, built byTestClient::resource. - Row
- One data row of a rendered table.
- RowActions
- The action targets of one row.
- Search
Group - One resource’s results.
- Search
Result - One record a global search lists.
- Section
- One
Sectionblock. - Stat
Tile - One stat tile.
- Submission
- A form post being built: the pairs it sends, keyed by the form’s field enum
K. - Summary
Figure - One summary under a list’s rows.
- Tab
- One tab of a
Tabsblock. - TabLink
- One tab of a list’s tab bar.
- Test
Client - Sends requests carrying cookies and tenant.
- Wizard
Step - One step of a
Wizardblock.
Enums§
- Empty
Reason - What emptied a table, as its zero-rows message’s
data-emptynames it. - Error
Kind - Why a field renders an error, as its error slot’s
data-errornames it. - Ignored
Reason - Why a table ignored a requested filter, as the banner’s
data-ignorednames it. - Import
Refusal - Why an import refused a whole file, as its alert’s
data-import-refusalnames it. - Picked
- What the page a create framed by a creatable choice’s dialog lands on offers.
Constants§
- TEST_
DATABASE_ URL - The variable naming the database
test_dbconnects to.
Functions§
- action_
badge - The count a header action’s button shows as its badge, posting to
url.Nonewhen no button posts there or it shows no badge. - action_
label - The text of the button posting to
url, its icon aside.Nonewhen no button posts there. - action_
tooltip - The hint the button posting to
urlshows on hover.Nonewhen no button posts there or it shows none. - area_
back_ link - The
hrefof an area’s link back to the panel, orNoneoutside every area. - authenticator_
code - The code an authenticator app holding
secretshows now. - authenticator_
code_ at - The six-digit code an authenticator app holding the base32
secretshows atunix_secs. - bell
- The bell
htmlrenders, orNonewhen the page shows none. - body_
bytes - Collect a response body as bytes.
- body_
string - Collect a response body as a lossy UTF-8 string.
- charts
- The charts
htmlrenders, in document order. - column_
picker - The toggleable columns the column picker offers, in order, or
Nonewhen the table renders no picker. - columns
- The names of the columns the table’s header shows, in order, without the bulk and actions columns.
- confirms_
first - Whether the button posting to
actionasks first: a confirming trigger is a plain button that opens the dialog, a direct write is a submit button.Nonewhen no button posts there. - cookie_
header - One
Cookieheader value from(name, value)pairs, orNonewhen empty. - create_
option_ links - Each creatable choice’s link on the page.
- declined_
message - The message a record fn declined the save with, which the form renders above its fields in
an element carrying
data-declined. - detail_
entries - The entries a detail page renders, in document order, a nested block’s in its place.
- dirty_
form - Whether a form renders dirty, so leaving the page asks first: a refused save keeps what the
user typed, and the server marks its form with
data-form-dirty. - disabled_
actions - The custom actions
htmlshows disabled, in document order: a row’s, or a record page header’s. - empty_
table - The zero-rows message of
html, orNonewhen the table renders rows. - external_
sign_ out - Where a panel behind external auth sends a user out to: the page it refuses them on, and the
page its Sign out answers with, link the app’s sign-out from a
data-external-sign-outelement. - field_
error - Why the field posting
namewas refused, orNonewhen it renders no error. - field_
error_ message - The sentence rendered under the field posting
name, orNonewhen it renders no error. - filter_
options - The options of the select or checklist filter
name, orNonewhennamenames neither. A checklist offering no option reads as an empty list, since its control still renders. - find_
href_ with - The first
hrefinhtmlthat containsneedle, its entities decoded. - form_
body - URL-encode
(key, value)pairs into an urlencoded form body. - groups
- The groups of
htmlin document order, empty when the table renders ungrouped. A group holds the rows from its header to the next one. - ignored_
filters - The filters the banner of
htmllists as ignored, in its order; empty without a banner. - impersonate_
buttons - The
user_ids theauth::impersonate_buttonforms ofhtmlact as, in document order. - impersonation_
banner - The banner
htmlshows, orNonewhile the signed-in user acts as themselves. - import_
columns - The form keys the import page of
htmllists as the columns a file may name, in order. - import_
errors - The values the import page of
htmllists as refused, in its order; empty when it lists none. - import_
refusal - Why the import page of
htmlrefused the whole file, orNonewhen it did not. - inline_
scripts - The text of each script the page carries inline, in document order.
- input_
value - Reads the value the named
<input>s post when the form submits untouched, in either attribute order or quote style: the last one’svalue, skipping a radio or checkbox left unchecked. A toggle readstrueor its hiddenfalse, and a radio choice its checked option, or the hidden blank before them when none is checked. - input_
values - Reads every value the named
<input>s post when the form submits untouched, in document order, skipping a radio or checkbox left unchecked: each row a file list keeps posts one. - language_
choices - The locales the shell’s language menu offers, in the order the panel lists them; empty when the page shows no menu.
- migrated_
db - A
Dbovermodelswhose tablesmigrationsmade, holding no rows: what the app’s migrations add beside the models, such as a foreign key or a check constraint written by hand, holds in the test too, wheretest_dbpushes the models’ schema alone. - mount
panelmounted on a router holdingdb, beside the app’s own discovered pages and routes: the router an app builds, without its asset bundle.- mount_
with_ handle mount’s router and the mounted panel’s handle, whichTestClient::panelresolvesTestClient::resource’s URLs in.- multipart_
body - Builds a multipart body, one part per entry:
Noneis a text part,Some("")the browser’s “no file chosen” part,Some(name)a chosen file. - nav_
badge - The badge text of the sidebar entry linking to
href, orNonewhen that entry shows no badge or no entry links there. - nav_
groups - The sidebar’s groups, in the order it lists them.
- nav_
links - The
hrefof each sidebar entry that links somewhere, in the order the sidebar lists them. - notification
- The flash notification a response set for the next page, decoded.
- now
- Seconds since the Unix epoch.
- page_
direction - The direction the page’s text runs in,
ltrorrtl, as its<html dir>names it. - page_
filter_ bar - The filter bar
htmlrenders, orNonewithout one. - page_
language - The language the page reads in, as its
<html lang>names it. - page_
title - The page’s heading, as its
[data-page-title]holds it;Nonewhen it has none. - picked
- What the landing page of a framed create offers, or
Noneon any other page. - posts_
picking - Whether the page’s guarded form posts back in pick mode, so a refused save of a create framed by a creatable choice’s dialog stays in the dialog.
- provider_
buttons - The provider buttons a login or sign-up page shows, as each provider’s key and the link that starts its sign-in, in order.
- record_
navigation - The tabs of the navigation a record’s page renders, in document order: each tab’s
data-record-nav, and whetheraria-currentmarks it. Empty without a navigation. - record_
tables - The record tables
htmlrenders, in document order. - recovery_
codes - The recovery codes the page shows, once, after a set-up or a regeneration; empty when it shows none.
- refreshes_
to - The URL a
<meta http-equiv="refresh">moves the page on to. - refusal
- The declaration mistakes a panel refused to mount with, for a test to match on their
kind. - response_
cookies - The
(name, value)pairs a response’sSet-Cookieheaders carry. - rich_
text_ values - The HTML of each rich text value
htmlrenders, in document order. - robots
- The search engine instructions the page’s robots tag names,
Nonewhen it has no such tag. - row_
actions - The action targets of the row whose checkbox value or action URL carries
key, orNonewhen no row matches. - row_
keys - The record key of every row in document order, read from its bulk checkbox: a row with no checkbox has none to read.
- rows
- The data rows of
htmlin document order, excluding group headers. - search_
box - Where the topbar’s search box submits its term, or
Nonewhen the page shows no box. - search_
results - The results
htmllists, by resource in document order: the results page’s, or the topbar box’s. - sections
- The sections
htmlrenders, in document order: a nested section’s after the one holding it, whosekeyshold the nested section’s too. - selects_
matching - Whether the bulk bar offers to select every record the list’s query selects, beyond its page.
- session_
cookie_ value - The value of the session cookie a response set, on whichever panel, if any.
- set_
cookie_ header - The full
Set-Cookieheader forname, so tests can assert attributes. - sortable_
columns - The names of the columns whose header sorts the table, in order: those the header marks with
aria-sort. - stale_
form - Whether the edit form refuses the save because another save changed the record since the form
opened: it renders an element carrying
data-stale. - stats
- The stat tiles
htmlrenders, in document order. - summaries
- The summaries of every list
htmlrenders, in document order. - tab_
links - The tabs of every list
htmlrenders, in document order. - tabs
- The tabs of every
Tabsblockhtmlrenders, in document order: a nested block’s after the tab holding it, whosekeyshold the nested block’s too. - tenant_
page_ link - The
hrefof the tenant menu’s link to the pagepagenames,profilefor the tenant settings orregistrationfor a new tenant;Nonewhen the menu has no such link. - test_db
- A
Dbholding the tables ofmodelsand no rows. - trail
- The topbar’s trail: each step’s text, with its
hrefunless it is the page itself. - two_
factor_ secret - The authenticator key a set-up shows, in base32, or
Nonewhen the page shows no set-up. - two_
factor_ state - Which view of the settings page renders:
off,setuporon, as its form’sdata-two-factornames it;Nonewhen the page shows recovery codes instead. - widgets
- The names of the widgets a page’s grid renders, in order:
RecentOrdersWidgetisrecent-orders. - wizard_
steps - The steps of every
Wizardblockhtmlrenders, in document order.
Type Aliases§
- FieldOf
- The field enum of
R’s record form, e.g.PostFormField.