Download the PHP package luttje/livewire-gloom without Composer
On this page you can find all versions of the php package luttje/livewire-gloom. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package livewire-gloom
Livewire Gloom
Add functions to Laravel Dusk for working with Livewire.
[!Warning] This package is still in development. It is not yet ready for production use and the API may change at any time.
Provided macros
The examples below test the NameComponent Livewire component.
waitUntilLivewireCommitSucceeds
It can be tricky to know if Livewire finished a request cycle. You can work
with $browser->pause(...) but that's not very reliable.
The waitUntilLivewireCommitSucceeds method waits until Livewire finished a
request cycle for the specified method (and optionally parameters).
The above call won't match the request if the call has no parameters, or has different parameters. If you don't care about the parameters, you can omit them.
waitUntilLivewireCommitFails
The inverse of waitUntilLivewireCommitSucceeds.
clickAndWaitUntilLivewireCommitSucceeds
This sets up waitUntilLivewireCommitSucceeds to listen for a Livewire request
cycle and clicks the element.
waitUntilLivewireUpdateSucceeds
It can be tricky to know if Livewire finished a request cycle surrounding the
updating of a property. You can work with $browser->pause(...) but that's not
very reliable.
The waitUntilLivewireUpdateSucceeds method waits until Livewire finished a
request cycle for the specified property keys.
Or for multiple properties:
With this last example the browser will wait until an update cycle is finished
in which both the age and job livewire properties are updated.
If those properties are deferred (by default) then Livewire will wait
a request is made.
In the example above they are deferred until clicking @split-button-debounced.
Regex matching
You can use Regex matching in waitUntilLivewireUpdateSucceeds, just start the
property key with a / and end it with /:
waitUntilLivewireUpdateFails
The inverse of waitUntilLivewireUpdateSucceeds.
clickAndWaitUntilLivewireUpdateSucceeds
This sets up waitUntilLivewireUpdateSucceeds to listen for a Livewire request
cycle and clicks the element.
The action parameter
Sometimes a sequence of actions may trigger too fast for you to listen for a Livewire commit or update:
Because the waitUntilLivewireCommitSucceeds sets up the listener, it will
miss the commit that happened before it was set up. The test will then fail
with a timeout exception.
In such a situation you will want to be sure that before an action is started, we setup the listener. That way we don't miss the commit. To reiterate we want to:
- Set up the listener for the Livewire commit
- Click the button which triggers the Livewire commit
- Wait for the listener to be triggered by the Livewire commit (succeeding or failing)
- Assert now that we know the Livewire commit is finished
You can ensure of the above sequence by providing a closure, which we call an action. It will be executed after the listener is set up. The following functions support this:
waitUntilLivewireCommitSucceedswaitUntilLivewireCommitFailswaitUntilLivewireUpdateSucceedswaitUntilLivewireUpdateFails
Here is an example how you can use this action parameter with
waitUntilLivewireCommitSucceeds:
Internally the clickAndWaitUntilLivewireCommitSucceeds and
clickAndWaitUntilLivewireUpdateSucceeds functions use the action parameter
to call click on the Browser. So the above example can be simplified by using
either of those functions.
[!Note] All of the above examples are taken from the tests. If you want to see more code surrounding the examples, check out those tests.
To generate the examples, run
composer compile-readme. This is done through luttje/php-example-tester.
Installation
You can install the package via composer:
Usage
Create a new Dusk test case and use the macros described above:
Testing
Make sure you have installed the Dusk Chrome driver by running:
Then run the tests with:
License
The MIT License (MIT). Please see License File for more information.
e (MIT). Please see License File for more information.
