feat($try-on-mount): init

indexes.json

@@ -32,6 +32,13 @@
       "category": "Component",
       "description": "safe `onDestroy`"
     },
+    {
+      "name": "tryOnMount",
+      "package": "shared",
+      "docs": "/shared/tryOnMount/",
+      "category": "Component",
+      "description": "safe `onMount`"
+    },
     {
       "name": "utils",
       "package": "shared",

packages/core/indexes.json

@@ -32,6 +32,13 @@
       "category": "Component",
       "description": "safe `onDestroy`"
     },
+    {
+      "name": "tryOnMount",
+      "package": "shared",
+      "docs": "/shared/tryOnMount/",
+      "category": "Component",
+      "description": "safe `onMount`"
+    },
     {
       "name": "utils",
       "package": "shared",

packages/functions.md

@@ -9,6 +9,7 @@
 
 ### Component
   - [`tryOnDestroy`](/shared/tryOnDestroy/) — safe `onDestroy`
+  - [`tryOnMount`](/shared/tryOnMount/) — safe `onMount`
 
 ### Utilities
   - [`whenever`](/shared/whenever/) — shorthand for watching value to be truthy

packages/shared/index.ts

@@ -1,3 +1,4 @@
 export * from './tryOnDestroy'
+export * from './tryOnMount'
 export * from './utils'
 export * from './whenever'

packages/shared/tryOnMount/index.md

@@ -0,0 +1,15 @@
+---
+category: Component
+---
+
+# tryOnMount
+
+Safe `onMount`. Call `onMount()` if it's inside a component lifecycle, if not, run just call the function.
+
+## Usage
+
+```js
+import { tryOnMount } from '@svelte-use/core'
+
+tryOnMount(() => {})
+```

packages/shared/tryOnMount/index.ts

@@ -0,0 +1,19 @@
+import { onMount } from 'svelte'
+import { tryOnDestroy } from '../tryOnDestroy'
+import { Fn, noop, tryGetCurrentComponent } from '../utils'
+
+export type OnMountFn = Fn | (() => Fn)
+
+/**
+ * Safe `onMount`. Call `onMount()` if it's inside a component lifecycle, if not, run just call the function.
+ *
+ * @param fn
+ */
+export function tryOnMount(fn: OnMountFn) {
+  if (tryGetCurrentComponent()) {
+    onMount(fn)
+  } else {
+    const cb = fn() || noop
+    tryOnDestroy(cb)
+  }
+}