feat(guide/migration): Added string parameter changes of 'watch'

fix(api/instance-methods): Updated the behavior with a string parameter
feat(api/instance-methods): Added an example for watching deep paths
vuejs · yusufkandemir · yusufkandemir · yusufkandemir · Jul 21, 2020 · yusufkandemir
diff --git a/src/api/instance-methods.md b/src/api/instance-methods.md
@@ -14,7 +14,7 @@

 - **Usage:**

-  Watch an expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The expression only accepts dot-delimited paths. For more complex expressions, use a function instead.
+  Watch a string expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The string expression only accepts top-level data and component property names. For more complex expressions, use a function instead.
diff --git a/src/api/instance-methods.md b/src/api/instance-methods.md
@@ -14,7 +14,7 @@

 - **Usage:**

-  Watch an expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The expression only accepts dot-delimited paths. For more complex expressions, use a function instead.
+  Watch a string expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The string expression only accepts top-level data and component property names. For more complex expressions, use a function instead.
-  Watch a string expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The string expression only accepts top-level data and component property names. For more complex expressions, use a function instead.
+  Watch a reactive property or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value for the given property. We can only pass top-level `data`, `prop`, or `computed` property name as a string. For more complex expressions or nested properties, use a function instead.
diff --git a/src/api/instance-methods.md b/src/api/instance-methods.md
@@ -32,7 +36,17 @@
        // do something
      })

-      // function
+      // function for watching a deep path
-      // function for watching a deep path
+      // function for watching a single nested property
diff --git a/src/api/instance-methods.md b/src/api/instance-methods.md
-      // function
+      // function for watching a deep path
+      this.$watch(
+        // Only `this.c.d` will be watched
	Watch a string expression or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value. The string expression only accepts top-level data and component property names. For more complex expressions, use a function instead.
	Watch a reactive property or a computed function on the Vue instance for changes. The callback gets called with the new value and the old value for the given property. We can only pass top-level `data`, `prop`, or `computed` property name as a string. For more complex expressions or nested properties, use a function instead.
	// function for watching a deep path
	// function for watching a single nested property