diff --git a/src/api/instance-methods.md b/src/api/instance-methods.md index 64cdaffac7..ef09dce96f 100644 --- a/src/api/instance-methods.md +++ b/src/api/instance-methods.md @@ -121,7 +121,9 @@ - **Option: deep** - To also detect nested value changes inside Objects, you need to pass in `deep: true` in the options argument. Note that you don't need to do so to listen for array mutations. + To also detect nested value changes inside Objects, you need to pass in `deep: true` in the options argument. This option also can be used to watch array mutations. + + > Note: when mutating (rather than replacing) an Object or an Array and watch with deep option, the old value will be the same as new value because they reference the same Object/Array. Vue doesn't keep a copy of the pre-mutate value. ```js vm.$watch('someObject', callback, {