class HtmxAttributesTest
Test all attribute-related Htmx public methods.
Attributes
#[CoversClass(Htmx::class)]
#[Group('Htmx')]
Hierarchy
- class \Drupal\Tests\UnitTestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait extends \PHPUnit\Framework\TestCase
- class \Drupal\Tests\Core\Htmx\HtmxAttributesTest extends \Drupal\Tests\UnitTestCase
Expanded class hierarchy of HtmxAttributesTest
File
-
core/
tests/ Drupal/ Tests/ Core/ Htmx/ HtmxAttributesTest.php, line 18
Namespace
Drupal\Tests\Core\HtmxView source
class HtmxAttributesTest extends UnitTestCase {
/**
* Class under test.
*/
protected Htmx $htmx;
/**
* Mocked Url object.
*/
protected Url $url;
/**
* {@inheritdoc}
*/
protected function setUp() : void {
parent::setUp();
$this->htmx = new Htmx();
$generated = new GeneratedUrl();
$generated->setGeneratedUrl('https://www.example.test/common-test/destination');
$this->url = $this->getMockBuilder(Url::class)
->disableOriginalConstructor()
->onlyMethods([
'toString',
])
->getMock();
$this->url
->expects($this->any())
->method('toString')
->willReturn($generated);
}
protected function apply() : array {
$render = [];
$this->htmx
->applyTo($render);
return $render;
}
/**
* Test get method.
*/
public function testHxGet() : void {
$this->htmx
->get($this->url);
$render = $this->apply();
// The paths in GitLabCI include a subfolder.
$this->assertTrue(isset($render['#attributes']['data-hx-get']));
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-get']);
// Verify no parameters.
$this->htmx
->get();
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-get']));
$this->assertEquals('', $render['#attributes']['data-hx-get']);
}
/**
* Test post method.
*/
public function testHxPost() : void {
$this->htmx
->post($this->url);
$render = $this->apply();
// The paths in GitLabCI include a subfolder.
$this->assertTrue(isset($render['#attributes']['data-hx-post']));
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-post']);
// Verify no parameters.
$this->htmx
->post();
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-post']));
$this->assertEquals('', $render['#attributes']['data-hx-post']);
}
/**
* Test put method.
*/
public function testHxPut() : void {
$this->htmx
->put($this->url);
$render = $this->apply();
// The paths in GitLabCI include a subfolder.
$this->assertTrue(isset($render['#attributes']['data-hx-put']));
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-put']);
// Verify no parameters.
$this->htmx
->put();
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-put']));
$this->assertEquals('', $render['#attributes']['data-hx-put']);
}
/**
* Test patch method.
*/
public function testHxPatch() : void {
$this->htmx
->patch($this->url);
$render = $this->apply();
// The paths in GitLabCI include a subfolder.
$this->assertTrue(isset($render['#attributes']['data-hx-patch']));
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-patch']);
// Verify no parameters.
$this->htmx
->patch();
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-patch']));
$this->assertEquals('', $render['#attributes']['data-hx-patch']);
}
/**
* Test delete method.
*/
public function testHxDelete() : void {
$this->htmx
->delete($this->url);
$render = $this->apply();
// The paths in GitLabCI include a subfolder.
$this->assertTrue(isset($render['#attributes']['data-hx-delete']));
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-delete']);
// Verify no parameters.
$this->htmx
->delete();
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-delete']));
$this->assertEquals('', $render['#attributes']['data-hx-delete']);
}
/**
* Test on method.
*/
public function testHxOn(string $event, string $expected) : void {
$this->htmx
->on($event, 'someAction');
$render = $this->apply();
$this->assertTrue(isset($render['#attributes'][$expected]));
$this->assertEquals('someAction', $render['#attributes'][$expected]);
}
/**
* Provides data to ::testHxOn.
*
* @return array<int, string[]>
* Array of event, expected.
*/
public static function hxOnDataProvider() : array {
return [
[
'lowercase',
'data-hx-on-lowercase',
],
[
'already-kebab-case',
'data-hx-on-already-kebab-case',
],
[
'snake_case',
'data-hx-on-snake-case',
],
[
'camelCaseEvent',
'data-hx-on-camel-case-event',
],
[
'htmx:beforeRequest',
'data-hx-on-htmx-before-request',
],
[
'::beforeRequest',
'data-hx-on--before-request',
],
];
}
/**
* Test pushUrl method.
*/
public function testHxPushUrl(bool|Url $value, string $attributeValue) : void {
$this->htmx
->pushUrl($value);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-push-url']));
$this->assertEquals($attributeValue, $render['#attributes']['data-hx-push-url']);
}
/**
* Test replaceUrl method.
*/
public function testHxReplaceUrl(bool|Url $value, string $attributeValue) : void {
$this->htmx
->replaceUrl($value);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-replace-url']));
$this->assertEquals($attributeValue, $render['#attributes']['data-hx-replace-url']);
}
/**
* Provides data to ::testHxPushUrl and :testHxReplaceUrl.
*
* @return array{bool, string}[]
* Array of <bool, string> expected.
*/
public static function booleanStringDataProvider() : array {
return [
[
TRUE,
'true',
],
[
FALSE,
'false',
],
];
}
/**
* Test pushUrl method with a Url object.
*/
public function testHxPushUrlAbsolute() : void {
$this->htmx
->pushUrl($this->url);
$render = $this->apply();
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-push-url']);
}
/**
* Test replaceUrl method with a Url object.
*/
public function testHxReplaceUrlAbsolute() : void {
$this->htmx
->replaceUrl($this->url);
$render = $this->apply();
$this->assertStringEndsWith('/common-test/destination', $render['#attributes']['data-hx-replace-url']);
}
/**
* Test swapOob method.
*/
public function testHxSwapOob(true|string $value, string $expected) : void {
$this->htmx
->swapOob($value);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-swap-oob']));
$this->assertEquals($expected, $render['#attributes']['data-hx-swap-oob']);
}
/**
* Provides data to ::testHxSwapOob.
*
* @return array{true|string, string}[]
* Array of true|string, expected.
*/
public static function hxSwapOobDataProvider() : array {
return [
[
TRUE,
'true',
],
[
'body:beforeend',
'body:beforeend',
],
];
}
/**
* Test vals method.
*/
public function testHxVals() : void {
$values = [
'myValue' => 'My Value',
];
$this->htmx
->vals($values);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-vals']));
$this->assertEquals('{"myValue":"My Value"}', $render['#attributes']['data-hx-vals']);
}
/**
* Test boost method.
*/
public function testHxBoost(bool $value, string $expected) : void {
$this->htmx
->boost($value);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-boost']));
$this->assertEquals($expected, $render['#attributes']['data-hx-boost']);
}
/**
* Test headers method.
*/
public function testHxHeaders() : void {
$values = [
'myValue' => 'My Value',
];
$this->htmx
->headers($values);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-headers']));
$this->assertEquals('{"myValue":"My Value"}', $render['#attributes']['data-hx-headers']);
}
/**
* Test request method.
*/
public function testHxRequest() : void {
$values = [
'timeout' => 100,
'credentials' => FALSE,
];
$this->htmx
->request($values);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-request']));
$this->assertEquals('{"timeout":100,"credentials":false}', $render['#attributes']['data-hx-request']);
}
/**
* Test validate method.
*/
public function testHxValidate(?bool $value, string $expected) : void {
if (is_null($value)) {
$this->htmx
->validate();
}
else {
$this->htmx
->validate($value);
}
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-validate']));
$this->assertEquals($expected, $render['#attributes']['data-hx-validate']);
}
/**
* Provides data to ::testHxValidate.
*
* @return array{?bool, string}[]
* Array of null|bool, string, expected.
*/
public static function hxValidateDataProvider() : array {
return [
[
TRUE,
'true',
],
[
FALSE,
'false',
],
[
NULL,
'true',
],
];
}
/**
* Test swap method.
*/
public function testSwap() : void {
// Simple case.
$this->htmx
->swap('afterbegin');
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-swap']));
$this->assertEquals('afterbegin ignoreTitle:true', $render['#attributes']['data-hx-swap']);
// Don't ignore the title.
$this->htmx
->swap('afterbegin', '', FALSE);
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-swap']));
$this->assertEquals('afterbegin', $render['#attributes']['data-hx-swap']);
// Use a modifier.
$this->htmx
->swap('beforeend', 'scroll:bottom');
$render = $this->apply();
$this->assertTrue(isset($render['#attributes']['data-hx-swap']));
$this->assertEquals('beforeend scroll:bottom ignoreTitle:true', $render['#attributes']['data-hx-swap']);
}
/**
* Test remaining methods.
*/
public function testHxSimpleAttributes(string $method, null|string|array $value, string $attribute, string|bool $expected) : void {
if (is_null($value)) {
$this->htmx
->{$method}();
}
else {
$this->htmx
->{$method}($value);
}
$render = $this->apply();
$this->assertTrue(isset($render['#attributes'][$attribute]));
$this->assertEquals($expected, $render['#attributes'][$attribute]);
}
/**
* Provides data to ::testHxSimpleStringAttributes.
*
* @return array{string, ?string, string, string|bool}[]
* Array of method, value, attribute, expected.
*/
public static function hxSimpleStringAttributesDataProvider() : array {
return [
[
'select',
'#info-details',
'data-hx-select',
'#info-details',
],
[
'select',
'info[data-drupal-selector="edit-select"]',
'data-hx-select',
'info[data-drupal-selector="edit-select"]',
],
[
'selectOob',
'#info-details',
'data-hx-select-oob',
'#info-details',
],
[
'selectOob',
[
'#info-details:afterbegin',
'#alert',
],
'data-hx-select-oob',
'#info-details:afterbegin,#alert',
],
[
'target',
'descriptor',
'data-hx-target',
'descriptor',
],
[
'trigger',
'event',
'data-hx-trigger',
'event',
],
[
'trigger',
[
'load',
'click delay:1s',
],
'data-hx-trigger',
'load,click delay:1s',
],
[
'confirm',
'A confirmation message',
'data-hx-confirm',
'A confirmation message',
],
[
'disable',
NULL,
'data-hx-disable',
TRUE,
],
[
'disabledElt',
'descriptor',
'data-hx-disabled-elt',
'descriptor',
],
[
'disinherit',
'descriptor',
'data-hx-disinherit',
'descriptor',
],
[
'encoding',
NULL,
'data-hx-encoding',
'multipart/form-data',
],
[
'encoding',
'application/x-www-form-urlencoded',
'data-hx-encoding',
'application/x-www-form-urlencoded',
],
[
'ext',
'name, name',
'data-hx-ext',
'name, name',
],
[
'historyElt',
NULL,
'data-hx-history-elt',
TRUE,
],
[
'include',
'descriptor',
'data-hx-include',
'descriptor',
],
[
'indicator',
'descriptor',
'data-hx-indicator',
'descriptor',
],
[
'inherit',
'descriptor',
'data-hx-inherit',
'descriptor',
],
[
'params',
'*',
'data-hx-params',
'*',
],
[
'params',
[
'not param1',
'param2',
'param3',
],
'data-hx-params',
'not param1,param2,param3',
],
[
'params',
[
'param1',
'param2',
'param3',
],
'data-hx-params',
'param1,param2,param3',
],
[
'preserve',
NULL,
'data-hx-preserve',
TRUE,
],
[
'history',
NULL,
'data-hx-history',
'false',
],
[
'prompt',
'A prompt message',
'data-hx-prompt',
'A prompt message',
],
[
'sync',
'closest form:abort',
'data-hx-sync',
'closest form:abort',
],
];
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
HtmxAttributesTest::$htmx | protected | property | Class under test. | |
HtmxAttributesTest::$url | protected | property | Mocked Url object. | |
HtmxAttributesTest::apply | protected | function | ||
HtmxAttributesTest::booleanStringDataProvider | public static | function | Provides data to ::testHxPushUrl and :testHxReplaceUrl. | |
HtmxAttributesTest::hxOnDataProvider | public static | function | Provides data to ::testHxOn. | |
HtmxAttributesTest::hxSimpleStringAttributesDataProvider | public static | function | Provides data to ::testHxSimpleStringAttributes. | |
HtmxAttributesTest::hxSwapOobDataProvider | public static | function | Provides data to ::testHxSwapOob. | |
HtmxAttributesTest::hxValidateDataProvider | public static | function | Provides data to ::testHxValidate. | |
HtmxAttributesTest::setUp | protected | function | Overrides UnitTestCase::setUp | |
HtmxAttributesTest::testHxBoost | public | function | Test boost method. | |
HtmxAttributesTest::testHxDelete | public | function | Test delete method. | |
HtmxAttributesTest::testHxGet | public | function | Test get method. | |
HtmxAttributesTest::testHxHeaders | public | function | Test headers method. | |
HtmxAttributesTest::testHxOn | public | function | Test on method. | |
HtmxAttributesTest::testHxPatch | public | function | Test patch method. | |
HtmxAttributesTest::testHxPost | public | function | Test post method. | |
HtmxAttributesTest::testHxPushUrl | public | function | Test pushUrl method. | |
HtmxAttributesTest::testHxPushUrlAbsolute | public | function | Test pushUrl method with a Url object. | |
HtmxAttributesTest::testHxPut | public | function | Test put method. | |
HtmxAttributesTest::testHxReplaceUrl | public | function | Test replaceUrl method. | |
HtmxAttributesTest::testHxReplaceUrlAbsolute | public | function | Test replaceUrl method with a Url object. | |
HtmxAttributesTest::testHxRequest | public | function | Test request method. | |
HtmxAttributesTest::testHxSimpleAttributes | public | function | Test remaining methods. | |
HtmxAttributesTest::testHxSwapOob | public | function | Test swapOob method. | |
HtmxAttributesTest::testHxValidate | public | function | Test validate method. | |
HtmxAttributesTest::testHxVals | public | function | Test vals method. | |
HtmxAttributesTest::testSwap | public | function | Test swap method. | |
RandomGeneratorTrait::getRandomGenerator | protected | function | Gets the random generator for the utility methods. | |
RandomGeneratorTrait::randomMachineName | protected | function | Generates a unique random string containing letters and numbers. | |
RandomGeneratorTrait::randomObject | public | function | Generates a random PHP object. | |
RandomGeneratorTrait::randomString | public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
UnitTestCase::$root | protected | property | The app root. | |
UnitTestCase::getClassResolverStub | protected | function | Returns a stub class resolver. | |
UnitTestCase::getConfigFactoryStub | public | function | Returns a stub config factory that behaves according to the passed array. | |
UnitTestCase::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |
UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |
UnitTestCase::setDebugDumpHandler | public static | function | Registers the dumper CLI handler when the DebugDump extension is enabled. | |
UnitTestCase::setupMockIterator | protected | function | Set up a traversable class mock to return specific items when iterated. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.