feat(nuxt): add useRequestURL helper

docs/5.community/5.framework-contribution.md

@@ -59,13 +59,13 @@ Once you've read the [general contribution guide](/docs/community/contribution),
 
 While working on a PR, you will likely want to check if your changes are working correctly.
 
-You can modify the example app in `playground/`, and run it with `yarn dev`. Please make sure not to commit it to your branch, but it could be helpful to add some example code to your PR description. This can help reviewers and other Nuxt users understand the feature you've built in-depth.
+You can modify the example app in `playground/`, and run it with `npm run dev`. Please make sure not to commit it to your branch, but it could be helpful to add some example code to your PR description. This can help reviewers and other Nuxt users understand the feature you've built in-depth.
 
 ## Testing
 
 Every new feature should have a corresponding unit test (if possible). The `test` folder in this repository is currently a work in progress, but do your best to create a new test following the example of what's already there.
 
-Before creating a PR or marking it as ready-to-review, ensure that all tests pass by running `yarn test` locally.
+Before creating a PR or marking it as ready-to-review, ensure that all tests pass by running `pnpm test:fixtures` locally.
 
 ## Linting
 
@@ -126,12 +126,6 @@ To contribute to Nuxt, you need to set up a local environment.
 git checkout -b my-new-branch
 ```
 
-::js-doc{file=packages/nuxt/src/test.js function=useState}
-::
-
-::doc-link{file=packages/nuxt/src/test.js function=useState}
-::
-
 ### Set Up Documentation Website in Local Environment
 
 The Nuxt documentation is currently deployed within [nuxt/nuxt.com](https://github.com/nuxt/nuxt.com) as a layer.

packages/nuxt/src/app/composables/index.ts

@@ -31,3 +31,4 @@ export { preloadComponents, prefetchComponents, preloadRouteComponents } from '.
 export { isPrerendered, loadPayload, preloadPayload, definePayloadReducer, definePayloadReviver } from './payload'
 export type { ReloadNuxtAppOptions } from './chunk'
 export { reloadNuxtApp } from './chunk'
+export { getRequestURL } from './url'

packages/nuxt/src/app/composables/url.ts

@@ -0,0 +1,9 @@
+import { getRequestURL as getServerRequestURL } from 'h3'
+import { useRequestEvent } from './ssr'
+
+export function getRequestURL() {
+  if (process.server) {
+    return getServerRequestURL(useRequestEvent())
+  }
+  return new URL(window.location.href)
+}

packages/nuxt/src/imports/presets.ts

@@ -33,6 +33,7 @@ const appPreset = defineUnimportPreset({
     'useRequestHeaders',
     'useRequestEvent',
     'useRequestFetch',
+    'getRequestURL',
     'setResponseStatus',
     'setPageLayout',
     'onNuxtReady',

test/basic.test.ts

@@ -838,6 +838,10 @@ describe('extends support', () => {
       const html = await $fetch('/extends')
       expect(html).toContain('test from project')
     })
+    it('has getRequestURL()', async () => {
+      const html = await $fetch('/url')
+      expect(html).toContain('path: /test')
+    })
   })
 
   describe('plugins', () => {

test/fixtures/basic/pages/url.vue

@@ -0,0 +1,9 @@
+<script setup>
+const url = getRequestURL()
+</script>
+
+<template>
+  <div>
+    <div>path: {{ url.pathname }}</div>
+  </div>
+</template>