docs: refactor

Author: posva

packages/docs/cookbook/testing.md

@@ -168,15 +168,15 @@ expect(store.someAction).toHaveBeenCalledTimes(1)
 
 ### Selective action stubbing
 
-Sometimes you may want to stub only specific actions while allowing others to execute normally. You can achieve this by passing an object with `include` or `exclude` arrays to the `stubActions` option:
+Sometimes you may want to stub only specific actions while allowing others to execute normally. You can achieve this by passing an array of action names to the `stubActions` option:
 
 ```js
 // Only stub the 'increment' and 'reset' actions
 const wrapper = mount(Counter, {
   global: {
     plugins: [
       createTestingPinia({
-        stubActions: { include: ['increment', 'reset'] }
+        stubActions: ['increment', 'reset']
       })
     ],
   },
@@ -193,32 +193,40 @@ store.fetchData() // executed normally
 expect(store.fetchData).toHaveBeenCalledTimes(1)
 ```
 
-Alternatively, you can exclude specific actions from stubbing:
+For more complex scenarios, you can pass a function that receives the action name and store instance, and returns whether the action should be stubbed:
 
 ```js
-// Stub all actions except 'fetchData'
+// Stub actions based on custom logic
 const wrapper = mount(Counter, {
   global: {
     plugins: [
       createTestingPinia({
-        stubActions: { exclude: ['fetchData'] }
+        stubActions: (actionName, store) => {
+          // Stub all actions that start with 'set'
+          if (actionName.startsWith('set')) return true
+
+          // Stub actions based on initial store state
+          if (store.isPremium) return false
+
+          return true
+        }
       })
     ],
   },
 })
 
 const store = useSomeStore()
 
-// This action will execute normally
-store.fetchData() // executed normally
+// Actions starting with 'set' are stubbed
+store.setValue(42) // stubbed
 
-// Other actions will be stubbed
-store.increment() // stubbed
-store.reset() // stubbed
+// Other actions may execute based on the initial store state
+store.fetchData() // executed or stubbed based on initial store.isPremium
 ```
 
 ::: tip
-If both `include` and `exclude` are provided, `include` takes precedence. If neither is provided or both arrays are empty, all actions will be stubbed (equivalent to `stubActions: true`).
+- An empty array `[]` means no actions will be stubbed (all actions execute normally)
+- The function is evaluated once at store setup time, receiving the store instance in its initial state
 :::
 
 You can also manually mock specific actions after creating the store:

packages/docs/zh/cookbook/testing.md

@@ -175,15 +175,15 @@ expect(store.someAction).toHaveBeenCalledTimes(1)
 
 ### 选择性 action 存根 %{#selective-action-stubbing}%
 
-有时你可能只想存根特定的 action，而让其他 action 正常执行。你可以通过向 `stubActions` 选项传递一个包含 `include` 或 `exclude` 数组的对象来实现：
+有时你可能只想存根特定的 action，而让其他 action 正常执行。你可以通过向 `stubActions` 选项传递一个 action 名称数组来实现：
 
 ```js
 // 只存根 'increment' 和 'reset' action
 const wrapper = mount(Counter, {
   global: {
     plugins: [
       createTestingPinia({
-        stubActions: { include: ['increment', 'reset'] }
+        stubActions: ['increment', 'reset']
       })
     ],
   },
@@ -200,32 +200,40 @@ store.fetchData() // 正常执行
 expect(store.fetchData).toHaveBeenCalledTimes(1)
 ```
 
-或者，你可以排除特定的 action 不被存根：
+对于更复杂的场景，你可以传递一个函数，该函数接收 action 名称和 store 实例，并返回是否应该存根该 action：
 
 ```js
-// 存根所有 action 除了 'fetchData'
+// 基于自定义逻辑存根 action
 const wrapper = mount(Counter, {
   global: {
     plugins: [
       createTestingPinia({
-        stubActions: { exclude: ['fetchData'] }
+        stubActions: (actionName, store) => {
+          // 存根所有以 'set' 开头的 action
+          if (actionName.startsWith('set')) return true
+
+          // 根据初始 store 状态存根 action
+          if (store.isPremium) return false
+
+          return true
+        }
       })
     ],
   },
 })
 
 const store = useSomeStore()
 
-// 这个 action 将正常执行
-store.fetchData() // 正常执行
+// 以 'set' 开头的 action 被存根
+store.setValue(42) // 存根
 
-// 其他 action 将被存根
-store.increment() // 存根
-store.reset() // 存根
+// 其他 action 可能根据初始 store 状态执行
+store.fetchData() // 根据初始 store.isPremium 执行或存根
 ```
 
 ::: tip
-如果同时提供了 `include` 和 `exclude`，`include` 优先。如果两者都没有提供或两个数组都为空，所有 action 都将被存根（等同于 `stubActions: true`）。
+- 空数组 `[]` 表示不存根任何 action（所有 action 正常执行）
+- 函数在 store 设置时被评估一次，接收处于初始状态的 store 实例
 :::
 
 你也可以在创建 store 后手动模拟特定的 action：