feat(tryOnBeforeUnmount): new function (vitest-dev#709)

packages/shared/index.ts

@@ -21,6 +21,7 @@ export * from './syncRef'
 export * from './throttledWatch'
 export * from './toReactive'
 export * from './toRefs'
+export * from './tryOnBeforeUnmount'
 export * from './tryOnMounted'
 export * from './tryOnScopeDispose'
 export * from './tryOnUnmounted'

packages/shared/tryOnBeforeUnmount/index.md

@@ -0,0 +1,37 @@
+---
+category: Component
+---
+
+# tryOnUnmounted
+
+Safe `onBeforeUnmount`. Call `onBeforeUnmount()` if it's inside a component lifecycle, if not, do nothing
+
+## Usage
+
+```js
+import { tryOnBeforeUnmount } from '@vueuse/core'
+
+tryOnBeforeUnmount(() => {
+
+})
+```
+
+
+<!--FOOTER_STARTS-->
+## Type Declarations
+
+```typescript
+/**
+ * Call onUnmounted() if it's inside a component lifecycle, if not, do nothing
+ *
+ * @param fn
+ */
+export declare function tryOnBeforeUnmount(fn: Fn): void
+```
+
+## Source
+
+[Source](https://github.com/vueuse/vueuse/blob/main/packages/shared/tryOnBeforeUnmount/index.ts) • [Docs](https://github.com/vueuse/vueuse/blob/main/packages/shared/tryOnBeforeUnmount/index.md)
+
+
+<!--FOOTER_ENDS-->

packages/shared/tryOnBeforeUnmount/index.ts

@@ -0,0 +1,12 @@
+import { getCurrentInstance, onBeforeUnmount } from 'vue-demi'
+import { Fn } from '../utils'
+
+/**
+ * Call onBeforeUnmount() if it's inside a component lifecycle, if not, do nothing
+ *
+ * @param fn
+ */
+export function tryOnBeforeUnmount(fn: Fn) {
+  if (getCurrentInstance())
+    onBeforeUnmount(fn)
+}