What is the current behavior?

GitHub Issue Number: #6373

It's a regular developer requirement to need @Watch decorated methods to fire not only on change, but also during initialisation. At present, devs must do this manually within hooks like connectedCallback()

What is the new behavior?

By passing {immediate: true} (e.g. @Watch('propName', {immediate: true})) devs can now fire watch methods during initialisation. The method will fire for class property default values and also incoming values set via initial element attributes / props.

There's a slight difference in behaviour from dist to dist-custom-elements in that because dist-custom-elements components are native elements the watcher will fire for both default class values AND incoming values set via initial element attributes / props, whilst dist components (because they're lazily loaded) will only fire the default class value OR incoming values set via initial element attributes / props

Closes #6373

Documentation

stenciljs/site#1568

Does this introduce a breaking change?

• Yes
• No

Testing

Other information