Watchers
基本の例
算出プロパティを使うと、派生した値を宣言的に算出することができるようになります。しかしながら、状態の変更に応じて「副作用」を実行する必要とする場合があります。たとえば、DOM が変化する、あるいは非同期処理の結果に基づいて、別の状態にに変更した場合といったものです。
Option API では、watch
オプション を使って、リアクティブなプロパティが変更されるたびに関数を実行することができます:
<script setup> import { ref, watch } from 'vue' const question = ref('') const answer = ref('Questions usually contain a question mark. ;-)') // watch works directly on a ref watch(question, async (newQuestion, oldQuestion) => { if (newQuestion.indexOf('?') > -1) { answer.value = 'Thinking...' try { const res = await fetch('https://yesno.wtf/api') answer.value = (await res.json()).answer } catch (error) { answer.value = 'Error! Could not reach the API. ' + error } } }) </script> <template> <p> Ask a yes/no question: <input v-model="question" /> </p> <p>{{ answer }}</p> </template> //下は<script setup>でないcompostionAPIのやり方 export default { data() { return { question: '', answer: 'Questions usually contain a question mark. ;-)' } }, watch: { // 問題内容が変更されるたびに、関数が実行されます。 question(newQuestion, oldQuestion) { if (newQuestion.indexOf('?') > -1) { this.getAnswer() } } }, methods: { async getAnswer() { this.answer = 'Thinking...' try { const res = await fetch('https://yesno.wtf/api') this.answer = (await res.json()).answer } catch (error) { this.answer = 'Error! Could not reach the API. ' + error } } } }
<p> Ask a yes/no question: <input v-model="question" /> </p> <p>{{ answer }}</p>
watch
オプションはドットで区切られたパスをキーとして使うこともできます。
export default { watch: { // 注意 単純なパスのみ対応しています。式は対応していません。 'some.nested.key'(newValue) { // ... } } }
Deep Watchers
watch
はデフォルトではネストが浅い場合にしか対応していません: そのため、コールバックは監視対象のプロパティに新しい値が割り当てられた場合にしか実行されません。- そのため、ネストしたプロパティの変更があった場合には実行されません。もし、ネストしたすべての変更でコールバックが実行されるようにする場合、deep watcher を使用する必要があります。
const obj = reactive({ count: 0 }) watch(obj, (newValue, oldValue) => { // fires on nested property mutations // Note: `newValue` will be equal to `oldValue` here // because they both point to the same object! }) obj.count++ //下は<script setup>でないcompostionAPIのやり方 export default { watch: { someObject: { handler(newValue, oldValue) { // 注意:オブジェクト自体が置き替わらない限り、 // ネストした変更では、 `newValue` は、`oldValue` と // 等しくなります。 }, deep: true } } }
使用上の注意
deep watch は、監視対象のオブジェクトのネストされた全てのプロパティをトラバースする必要があるため、大きなデータ構造で使用するときにはコストが高くなります。使用するときは、どうしても必要なときにだけ使用し、パフォーマンスへの影響に注意しましょう。
Eager Watchers
watch
は、デフォルトでは、遅延して実行されます: 監視対象の値が変更するまでコールバックは実行されません。しかし、同様のコールバックのロジックを先に実行したい場合もあります。- たとえば、初期値のデータを読み込み、関連する状態が変更されるたび、再びデータを読み込みたいときです。
handler
関数と immediate: true
オプションを設定したオブジェクトを利用して宣言することで、監視対象のコールバック関数をすぐ実行させることができます:
export default { // ... watch: { question: { handler(newQuestion) { // コンポーネントが生成されるとすぐに実行されます。 }, // 前倒しして、コールバックの実行を強制します。 immediate: true } } // ... }
コールバックが実行されるタイミング
リアクティブな状態が変更されるとき、Vue コンポーネントの更新と生成された watcher コールバックを実行します。
デフォルトでは、ユーザーが生成した watcher のコールバックは Vue コンポーネントが更新される前に呼ばれます。これはつまり、コールバック内で DOM へアクセスしようとすると、DOM は Vue が更新を適用される前の状態です。
もし Vue の更新後に watcher コールバック内で DOM へアクセスしたいとき、flush: 'post'
オプションで指定する必要があります:
export default { // ... watch: { key: { handler() {}, flush: 'post' } } }
this.$watch()
また、$watch() インスタンスメソッド
を使用して watcher を強制的に作成することが可能です:
export default { created() { this.$watch('question', (newQuestion) => { // ... }) } }
これは、条件付きで watcher をセットアップする必要があるときや、ユーザーの相互作用に応じる場合にのみ、何かを監視しないといけないときに役立ちます。これにより、watcher を早い段階で停止することができます。
Watcher の停止
watch
オプションを使って宣言した watchers、あるいは $watch()
インスタンスメソッドは、オーナーコンポーネントがアンマウントされた自動的に停止します。そのため、多くの場合において、watcher 自体が停止することを心配する必要はありません。
ごくまれに、オーナーコンポーネントがアンマウントされる前に停止する必要がある場合には、$watch()
API は次のような関数を返します:
const unwatch = this.$watch('foo', callback) // ...wathcer が必要なくなったとき: unwatch()
watchEffect()
watchEffectはlazyで、監視する対象のソースが変わるまでコールバックが起きません。
const url = ref('https://...') const data = ref(null) async function fetchData() { const response = await fetch(url.value) data.value = await response.json() } // fetch immediately fetchData() // ...then watch for url change watch(url, fetchData)
動画で紹介したコード
<template> <p>敵のHP:{{enemyHP}}</p> <p>ヒーローのHP:{{heroHP}}</p> <button :class="msgClass" @click.prevent="attack">攻撃</button> <p >{{msg}}</p> </template> <script setup> import { watch, ref, watchEffect } from 'vue'; const enemyHP = ref(100) const heroHP = ref(40) const msg = ref("") const msgClass = ref("") const attack = () => { enemyHP.value = enemyHP.value - Math.floor(Math.random() * 10) heroHP.value = heroHP.value - Math.floor(Math.random() * 5) msg.value = "" } watch(heroHP, (currHP, prevHP) => { console.log(currHP, prevHP) if (currHP < 20) { msg.value = "HPが半分をきった。まずい。" } if (prevHP - currHP > 3) { msg.value = "会心の一撃を喰らった。" } }) watchEffect(async () => heroHP.value == 40 ? msgClass.value = "blue" : heroHP.value <= 20 ? msgClass.value = "red" : "" ) </script> <style> .blue { color:blue } .red { color:red } </style>