> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/withastro/astro/llms.txt
> Use this file to discover all available pages before exploring further.
# Astro Global Object
> API reference for the Astro global object available in .astro files
The `Astro` global object is available in all `.astro` components and provides access to request data, routing information, and utilities for rendering.
## Properties
Component props passed from parent components or from `getStaticPaths()`.
```astro theme={null}
---
// MyComponent.astro
const { title, description } = Astro.props;
---
{title}
{description}
```
A standard [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object containing information about the current request.
```astro theme={null}
---
const userAgent = Astro.request.headers.get('user-agent');
const method = Astro.request.method;
---
```
A URL object constructed from the current request URL. Equivalent to `new URL(Astro.request.url)`.
```astro theme={null}
---
const pathname = Astro.url.pathname;
const searchParams = Astro.url.searchParams;
const origin = Astro.url.origin;
---
Current path: {pathname}
```
An object containing the values of dynamic route segments matched for this request.
```astro theme={null}
---
// src/pages/blog/[slug].astro
const { slug } = Astro.params;
---
Post: {slug}
```
The `site` from your Astro config, parsed as a URL instance. Returns `undefined` if not set.
```astro theme={null}
---
const siteUrl = Astro.site;
---
```
A string representing the Astro version, in the format `"Astro v5.x.x"`.
```astro theme={null}
```
Utilities for reading and manipulating cookies in on-demand routes.
```astro theme={null}
---
const sessionId = Astro.cookies.get('session');
Astro.cookies.set('theme', 'dark', {
path: '/',
maxAge: 60 * 60 * 24 * 7 // 1 week
});
---
```
An object that middleware can use to store extra information related to the request.
```astro theme={null}
---
// Access value set in middleware
const user = Astro.locals.user;
---
Welcome, {user.name}!
```
The IP address of the client making the request. Only available in on-demand routes.
```astro theme={null}
---
const ip = Astro.clientAddress;
---
```
A standard ResponseInit object for modifying the outgoing response.
```astro theme={null}
---
Astro.response.status = 404;
Astro.response.headers.set('X-Custom-Header', 'value');
---
```
Allows a component to recursively call itself.
```astro theme={null}
---
const { items } = Astro.props;
---
{items.map((item) => (
{Array.isArray(item) ? (
) : (
item
)}
))}
```
An object containing utility functions for working with slotted children.
### Methods
Check whether content for a slot name exists.
```astro theme={null}
---
const hasHeader = Astro.slots.has('header');
---
{hasHeader && }
```
Asynchronously renders the contents of a slot to a string of HTML.
```astro theme={null}
---
let html = '';
if (Astro.slots.has('default')) {
html = await Astro.slots.render('default');
}
---
```
The current locale computed from the URL of the request. Only available when i18n routing is configured.
```astro theme={null}
---
const locale = Astro.currentLocale; // 'en', 'fr', etc.
---
```
The best match between visitor's browser language preferences and supported locales. Only available in on-demand routes.
```astro theme={null}
---
const preferred = Astro.preferredLocale;
---
```
List of all locales that are both requested by the browser and supported by the site. Only available in on-demand routes.
```astro theme={null}
---
const locales = Astro.preferredLocaleList;
---
```
Whether the current route is prerendered or not.
```astro theme={null}
---
if (!Astro.isPrerendered) {
// Use on-demand features
}
---
```
The route pattern for the current route, stripped of the `srcDir` and `pages` folder.
```astro theme={null}
---
// src/pages/index.astro -> '/'
// src/pages/blog/[slug].astro -> '/blog/[slug]'
const pattern = Astro.routePattern;
---
```
The original pathname before any rewrites were applied. Useful for tracking the original URL.
```astro theme={null}
---
const original = Astro.originPathname;
const current = Astro.url.pathname;
---
```
## Methods
Create a response that redirects to another page.
```astro theme={null}
---
import type { APIContext } from 'astro';
export function GET({ redirect }: APIContext) {
return redirect('/login', 302);
}
---
```
Serve content from a different URL or path without redirecting the browser.
```astro theme={null}
---
export async function GET(context) {
return context.rewrite('/new-page');
}
---
```
Call an Action handler directly from your Astro component.
```astro theme={null}
---
import { actions } from 'astro:actions';
const result = await Astro.callAction(actions.getPost, { postId: 'test' });
---
```
Get the result of an Action submission when using a form POST.
```astro theme={null}
---
import { actions } from 'astro:actions';
const result = Astro.getActionResult(actions.myAction);
---
{result?.data &&
Success: {result.data}
}
{result?.error &&
Error: {result.error.message}
}
```
## Session
Utilities for handling sessions in on-demand rendered routes.
```astro theme={null}
---
// Get session data
const userId = await Astro.session.get('userId');
// Set session data
await Astro.session.set('userId', '123');
// Destroy session
await Astro.session.destroy();
---
```
## CSP (Content Security Policy)
Utilities to control CSP headers. Only available when CSP is enabled in config.
### Methods
Add a specific CSP directive to the route being rendered.
```astro theme={null}
---
Astro.csp?.insertDirective("default-src 'self' https://example.com");
---
```
Set the resource for the `style-src` directive.
```astro theme={null}
---
Astro.csp?.insertStyleResource('https://styles.cdn.example.com/');
---
```
Insert a single style hash to the route being rendered.
```astro theme={null}
---
Astro.csp?.insertStyleHash('sha256-1234567890abcdef');
---
```
Set the resource for the `script-src` directive.
```astro theme={null}
---
Astro.csp?.insertScriptResource('https://scripts.cdn.example.com/');
---
```
Insert a single script hash to the route being rendered.
```astro theme={null}
---
Astro.csp?.insertScriptHash('sha256-1234567890abcdef');
---
```