Caplin Trader 4.8.0

Class: module:br/presenter/testing/PresenterComponentFixture

module:br/presenter/testing/PresenterComponentFixture

The PresenterComponentFixture serves to create presenter components in order to test the component behavior.

Tests may use the PresenterComponentFixture to:

  • create a presenter component to test the model behavior: given("component.opened = true")
    and(component presentation model is in state A)
    when(component presentation model is modified)
    then(component presentation model is in new state B)
  • create a presenter component and bind it (using knockout) to the view template, to test the model and view behavior: given("component.viewOpened = true")
    and(component presentation model is in state A)
    and(component view is in state X)
    when(button clicked on component view)
    then(component presentation model is in new state B)
    and(component view is in new state Y)

Constructor

new module:br/presenter/testing/PresenterComponentFixture(sTemplateId, sPresentationModel)

Constructs a br.presenter.testing.PresenterComponentFixture.
Extends:
Parameters:
Name Type Description
sTemplateId String the HTML template id representing the view of the presenter component. Required, not-null.
sPresentationModel String the presentation model class name for the presenter component. Required, not-null.

Extends

Methods

addSubFixtures()

The ComponentFixture adds the following sub-fixtures:
  • model: the presentation model fixture, for manipulating and verifying properties in the presentation model
  • view: the view fixture, the view fixture, for manipulating and verifying the state of elements on the component's view
  • componentFrame: the component frame fixture, for verifying the state of the module:br/component/Frame housing the component
Inherited From:
See:
  • br.test.Fixture#addSubFixtures

addViewFixtureHandlers(viewHandlersMap)

Allows custom view handlers to be added. The ViewFixture's addViewHandlers method throws an exception if an attempt is made to override an existing handler.
Parameters:
Name Type Description
viewHandlersMap Map A map of handler name to handler class constructor reference
Inherited From:

canHandleExactMatch()

Inherited From:
See:
  • br.test.Fixture#canHandleExactMatch

canHandleProperty(sProperty)

PresenterComponentFixture handles properties 'opened' and 'viewOpened'.
Parameters:
Name Type Description
sProperty String The property to check.
See:
  • br.test.Fixture#canHandleProperty

doGiven(sProperty, vValue)

This method creates the presenter component (if property = 'opened') and binds it to the view template (if property = 'viewOpened') using the references to the template Id and presentation model provided in the constructor.
Parameters:
Name Type Description
sProperty String The property name
vValue Variant The value to check.
See:
  • br.test.Fixture#doGiven

doThen(sProperty, vValue)

doThen is not supported on the ComponentFixture.
Parameters:
Name Type Description
sProperty String name of the property
vValue String value of the property
Inherited From:
See:
  • br.test.Fixture#doThen

doWhen(sProperty, vValue)

doWhen is not supported on the ComponentFixture.
Parameters:
Name Type Description
sProperty String name of the property
vValue String value of the property
Inherited From:
See:
  • br.test.Fixture#doWhen

getComponent()

Returns the Component under test.
Inherited From:

onOpen(fCallback)

This method can be called to set a single function on the fixture which will be executed whenever the component is created and opened.
Parameters:
Name Type Description
fCallback function the function to execute on opening the component
Inherited From:

setSelectorMappings(selectorMappings)

Set the selector mappings to use with the view fixture. This method proxies the call to the module:br/test/ViewFixture#setSelectorMappings method.
Parameters:
Name Type Description
selectorMappings Object Map of selector mappings.
Inherited From:

setUp()

Upon set-up of the ComponentFixture, the ComponentFactory is configured not to create an ErrorComponent. If no component can be created with the given XML configuration, an exception will be thrown instead.
Inherited From:
See:
  • br.test.Fixture#setUp

tearDown()

Upon tear-down of the ComponentFixture, the component created is closed and the ComponentFactory is re-configured to its original settings.
Inherited From:
See:
  • br.test.Fixture#tearDown

tearDownOldComponentAndRecreateWithNewXML(sXml)

Tear down this fixture and and recreate the component with the passed in xml string.
Parameters:
Name Type Description
sXml String the xml string for the component.
Inherited From: