Nou Generator de prompt AI — scrie prompturi mai bune pentru ChatGPT, Claude și Gemini →

history.pushState / replaceState în JavaScript

Schimbă adresa din bara browserului fără reîncărcarea paginii; baza aplicațiilor cu o singură pagină.

Sintaxă
history.pushState(stare, "", url)
history.replaceState(stare, "", url)

Ce face history.pushState / replaceState

pushState adaugă o intrare nouă în istoric, cu adresa dată: bara de adrese se schimbă, dar pagina nu se reîncarcă. replaceState înlocuiește intrarea curentă (util pentru filtre, ca butonul Înapoi să nu treacă prin fiecare modificare).

Primul parametru este un obiect salvat cu intrarea, disponibil în history.state; al doilea nu mai este folosit (dă ""). Când utilizatorul apasă Înapoi sau Înainte, primești evenimentul popstate și trebuie să afișezi conținutul potrivit adresei.

Parametri

Parametru Descriere
stare Date asociate intrării (copiate, ca la structuredClone).
url Opțional. Adresa nouă, pe același domeniu.

Ce returnează

undefined.

Exemple

Exemplul 1: File de conținut cu adrese proprii

function arataFila(nume, adauga = true) {
  document.querySelector("#continut").textContent = `Conținut: ${nume}`;
  if (adauga) history.pushState({ fila: nume }, "", `/cont/${nume}/`);
}

window.addEventListener("popstate", (e) => arataFila(e.state?.fila ?? "profil", false));

arataFila("comenzi");
console.log(location.pathname, history.state);
history.replaceState({ fila: "comenzi", pagina: 2 }, "", "?pagina=2");
console.log(location.href);

Rezultat în browser

/cont/comenzi/ { fila: 'comenzi' }
https://www.exemplu.ro/cont/comenzi/?pagina=2

Greșeli frecvente

  • Schimbi adresa cu pushState și nu tratezi popstate. Butonul Înapoi schimbă adresa, dar pagina rămâne aceeași.
  • Dai o adresă de pe alt domeniu și primești SecurityError.

Comenzi înrudite

  • history.back / forward / go: Navighează înapoi sau înainte în istoricul filei, ca butoanele browserului.
  • location.reload / assign / replace: Reîncarcă pagina sau navighează la altă adresă, cu sau fără păstrarea paginii curente în istoric.
  • new URL(): Desface o adresă URL în părți (domeniu, cale, parametri) și o construiește corect la loc.
Comunitate & Schimb de cunoștințe

Întrebări & Exemple de Cod: history.pushState / replaceState

Ai o nelămurire despre utilizarea comenzii history.pushState / replaceState sau ai descoperit un truc / fragment de cod util? Distribuie-l cu ceilalți programatori!

💬

Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!

Nu au fost adăugate încă întrebări sau exemple de cod pentru această pagină. Dacă ai întâlnit o problemă sau ai un snippet util, adaugă-l mai jos pentru a-i ajuta pe ceilalți.

Comunitate Adaugă o întrebare sau distribuie un cod

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.