Skip to content

Commit 6c66809

Browse files
authored
Update README.md
1 parent 346bc14 commit 6c66809

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

README.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,17 @@ https://github.com/user-attachments/assets/69b4db6b-80c6-4527-b088-e10b68e0f18c
2323

2424
Note: `retry.actions` and `retry.action` are not suitable for the following scenarios:
2525

26-
1. When the order of the actions matters: the background retries are running independently to the rest of the actions.
27-
2. For a relative state change: for example, `homeassistant.toggle` and `fan.increase_speed` are relative actions while `light.turn_on` is an absolute action. The reason is that a relative action might change the state and only then a failure occurs. Performing it again might have an unintentional result.
28-
3. If any [action response data](https://www.home-assistant.io/docs/scripts/service-calls/#use-templates-to-handle-response-data) is needed: the actions are running in the background and therefore it's not possible to propagate responses.
26+
1. For a relative state change: for example, `homeassistant.toggle` and `fan.increase_speed` are relative actions while `light.turn_on` is an absolute action. The reason is that a relative action might change the state and only then a failure occurs. Performing it again might have an unintentional result.
27+
2. If any [action response data](https://www.home-assistant.io/docs/scripts/service-calls/#use-templates-to-handle-response-data) is needed: the actions are running in the background and therefore it's not possible to propagate responses.
28+
3. The order of performing the actions successfully is not guaranteed since retries are running in the background. It's possible however to use a synchronization statement which can be placed between 2 retry actions. For example:
29+
```
30+
wait_for_trigger:
31+
- trigger: state
32+
entity_id: domain.state_1
33+
to: "on"
34+
timeout: 60
35+
continue_on_timeout: false
36+
```
2937

3038
## `retry.action`
3139

0 commit comments

Comments
 (0)