Url

Reactive wrapper around Angular Router's current URL. Access the full URL as a signal.

Usage

import { Component } from '@angular/core';
import { url } from '@signality/core';

@Component({
  template: `
    <p>Current URL: {{ currentUrl() }}</p>
  `,
})
export class SharePage {
  readonly currentUrl = url(); 
}

Parameters

Parameter	Type	Description
options	UrlOptions	Optional configuration (see Options below)

Options

The UrlOptions extends CreateSignalOptions<string> and WithInjector:

Option	Type	Default	Description
absolute	boolean	false	Include origin (protocol + host)
equal	ValueEqualityFn<string>	-	Custom equality function (see more)
debugName	string	-	Debug name for the signal
injector	Injector	-	Optional injector for DI context

Return Value

Returns a Signal<string> containing the current URL.

Examples

Analytics tracking

import { Component, effect, inject } from '@angular/core';
import { url } from '@signality/core';
import { AnalyticsService } from './analytics.service';

@Component({ /* ... */ })
export class App {
  readonly analytics = inject(AnalyticsService);
  readonly currentUrl = url();
  
  constructor() {
    effect(() => {
      this.analytics.trackPageView(this.currentUrl()); 
    });
  }
}

Social share

import { Component, computed } from '@angular/core';
import { url } from '@signality/core';

@Component({
  template: `
    <div class="share-buttons">
      <a [href]="xUrl()" target="_blank">Share on X</a>
    </div>
  `,
})
export class ShareButtons {
  readonly currentUrl = url({ absolute: true });
  
  readonly xUrl = computed(() => 
    `https://x.com/intent/tweet?url=${encodeURIComponent(this.currentUrl())}`
  );
}

SSR Compatibility

On the server, the signal initializes with the current URL from the router's url property.

Type Definitions

interface UrlOptions extends CreateSignalOptions<string>, WithInjector {
  readonly absolute?: boolean;
}

function url(options?: UrlOptions): Signal<string>;

Related

• params — Access route parameters
• queryParams — Access query parameters
• fragment — Access URL fragment

Edit this page on GitHub Last updated: Mar 19, 2026, 23:28:23

PreviousTitleNextCva