Update abort-navigation.md

docs/content/3.api/3.utils/abort-navigation.md

@@ -1,63 +1,65 @@
 # `abortNavigation`
 
-`abortNavigation` is a helper function that prevents the navigation from taking place.
+`abortNavigation` is a helper function that prevents navigation from taking place and throws an error if one is set as a parameter.
 
-## Usage
+::alert{type="warning"}
+`abortNavigation` is only usable inside a [route middleware handler](/guide/directory-structure/middleware).
+::
+
+## Type
 
 ```ts
 abortNavigation(err?: Error | string): false
 ```
 
-`abortNavigation` takes one optional argument which can be of type `string` or an `Error` object.
+## Parameters
 
-- **err**: Optional error to be thrown by `abortNavigation()`.
+### `err`
 
-::alert{type="warning"}
-`abortNavigation()` is only usable inside a [route middleware handler](/guide/directory-structure/middleware).
-::
+- **Type**: [`Error`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Global_Objects/Error) | `string`
 
-Inside a route middleware handler, `abortNavigation()` will abort navigation, and throw an error if one is set as a parameter.
+  Optional error to be thrown by `abortNavigation`.
 
 ## Examples
 
-The example below shows how you can use `abortNavigation` in route middleware to prevent unauthorised route access.
+The example below shows how you can use `abortNavigation` in a route middleware to prevent unauthorized route access:
 
-```jsx
-// middleware/auth.ts
+```ts [middleware/auth.ts]
 export default defineNuxtRouteMiddleware((to, from) => {
- const user = useState('user')
- if (!user.value.isAuthorized) {
+  const user = useState('user')
+
+  if (!user.value.isAuthorized) {
     abortNavigation()
   }
- return navigateTo('/edit-post')
+
+  return navigateTo('/edit-post')
 })
 ```
 
-### `err` as a string
+### `err` as a String
 
-You can pass the error as a `string`.
+You can pass the error as a string:
 
 ```ts [middleware/auth.ts]
 export default defineNuxtRouteMiddleware((to, from) => {
- const auth = useState('auth')
- if (!user.value.isAuthorized) {
-    abortNavigation('This feature requires special permission.')
+  const auth = useState('auth')
+
+  if (!user.value.isAuthorized) {
+    abortNavigation('Insufficient permissions.')
   }
 })
 ```
 
-### `err` as an Error object
+### `err` as an Error Object
 
-You can pass the error as an `Error` object that includes the error code and a message.
+You can pass the error as an [`Error`](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Global_Objects/Error) object, e.g. caught by the `catch`-block:
 
 ```ts [middleware/auth.ts]
 export default defineNuxtRouteMiddleware((to, from) => {
- const auth = useState('auth')
- if (to.params.id === '1') {
-    abortNavigation({ 
-       statusCode: 401, 
-       statusMessage: 'This feature requires special permission.'
-    })
+  try {
+    /* code that might throw an error */
+  } catch (err) {
+    abortNavigation(err)
   }
 })
 ```