W skrócie
8 min czytaniaRóżnica między sendBeacon a fetch keepalive dotyczy kontroli, a nie dostarczania. navigator.sendBeacon() kolejkuje żądanie POST, które przeżywa stronę, i zwraca tylko true lub false, a Content-Type przeglądarka wyprowadza z typu przekazanej treści. fetch() z keepalive ustawionym na true daje własne nagłówki, inne metody i dostęp do odpowiedzi, a oba mechanizmy korzystają z tego samego budżetu 64 kibibajtów dla żądań w toku, zdefiniowanego w standardzie WHATWG Fetch.
Czym różnią się sendBeacon i fetch keepalive?
Praktyczna różnica między sendBeacon a fetch keepalive to kontrola: navigator.sendBeacon() kolejkuje żądanie POST, które przeżywa stronę, ale zwraca wyłącznie true lub false, a fetch() z keepalive: true pozwala wybrać metodę, ustawić własne nagłówki i odczytać odpowiedź serwera. Specyfikacja W3C Beacon mówi to wprost: "The sendBeacon() method does not provide ability to customize the request method, provide custom request headers, or change other processing properties of the request and response. Applications that require non-default settings for such requests should use the [FETCH] API with keepalive set to true." Oba działają na tym samym mechanizmie fetch, więc obowiązuje je jeden limit rozmiaru.
Ile danych mogą wysłać sendBeacon i fetch keepalive?
Żądanie keepalive może mieć treść o rozmiarze najwyżej 64 kibibajtów, czyli 65 536 bajtów. Standard WHATWG Fetch egzekwuje ten limit w algorytmie HTTP-network-or-cache fetch, zanim żądanie trafi do sieci:
If contentLength is non-null and httpRequest's keepalive is true, then:
- Let inflightKeepaliveBytes be 0.
- Let group be httpRequest's client's fetch group.
- Let inflightRecords be the set of fetch records in group whose request's keepalive is true and done flag is unset.
- For each fetchRecord of inflightRecords:
- Let inflightRequest be fetchRecord's request.
- Increment inflightKeepaliveBytes by inflightRequest's body's length.
- If the sum of contentLength and inflightKeepaliveBytes is greater than 64 kibibytes, then return a network error.
Uwaga w specyfikacji wyjaśnia tę liczbę: "The above limit ensures that requests that are allowed to outlive the environment settings object and contain a body, have a bounded size and are not allowed to stay alive indefinitely." Zanim uznasz, że dane się zmieszczą, zmierz zserializowaną treść w bajtach, a nie w znakach.
Czy limit 64 KiB jest wspólny dla żądań keepalive w toku?
Limit jest wspólny, a nie liczony osobno na wywołanie. Krok 5 sumuje contentLength z inflightKeepaliveBytes, czyli łączną długością treści wszystkich niezakończonych żądań keepalive w grupie fetch. Specyfikacja Beacon mówi to samo ze swojej strony: "Requests initiated via the Beacon API automatically set the keepalive flag, and developers can similarly set the same flag manually when using the Fetch API. All requests with this flag set share the same in-flight quota restrictions that is enforced within the Fetch API." Wywołania sendBeacon() i fetch(..., { keepalive: true }) konkurują o jeden budżet.
Zapas na kolejne wywołanie wynosi:
remaining bytes = 65536 - (sum of body lengths of unfinished keepalive requests)
Załóżmy, że w toku są raport o błędzie o rozmiarze 12 288 bajtów i paczka kliknięć o rozmiarze 8 192 bajtów. Zapas to 65 536 minus 20 480, czyli 45 056 bajtów. Podsumowanie sesji o rozmiarze 50 000 bajtów podnosi sumę do 70 480, więc fetch() zwraca błąd sieciowy, a sendBeacon() zwraca false. Jeśli połączysz wszystkie dane ze śledzenia zdarzeń w jedno wysłanie, ta arytmetyka przestanie ci przeszkadzać.
Jaki Content-Type ustawia sendBeacon dla poszczególnych typów treści?
sendBeacon nie pozwala samodzielnie ustawić Content-Type: przeglądarka wyprowadza go z typu przekazanej treści, a ta wartość decyduje, czy żądanie zostaje w trybie no-cors, czy wywołuje preflight CORS. Model przetwarzania w specyfikacji Beacon opisuje to rozgałęzienie:
If contentType is not null:
- Set corsMode to "cors".
- If contentType value is a CORS-safelisted request-header value for the
Content-Typeheader, set corsMode to "no-cors".- Append a
Content-Typeheader with value contentType to headerList.
Standard Fetch definiuje test dla tego nagłówka: "If mimeType's essence is not application/x-www-form-urlencoded, multipart/form-data, or text/plain, then return false." Fetch określa też, jaki Content-Type daje każdy typ treści:
| Treść przekazana do sendBeacon | Content-Type ustawiany przez przeglądarkę | Na liście dozwolonych CORS | Skutek między źródłami |
|---|---|---|---|
| ArrayBuffer, TypedArray, DataView | brak | nagłówek nie jest wysyłany | no-cors, bez preflightu |
| String | text/plain;charset=UTF-8 | Tak | no-cors, bez preflightu |
| URLSearchParams | application/x-www-form-urlencoded;charset=UTF-8 | Tak | no-cors, bez preflightu |
| FormData | multipart/form-data; boundary=... | Tak | no-cors, bez preflightu |
Blob z typem application/json | application/json | Nie | tryb CORS, wymagany preflight |
Specyfikacja Beacon podaje konsekwencję: "If the request does not contain a payload, or the request Content-Type is a CORS-safelisted request-header, then the request mode is no-cors." W przeciwnym razie, jak ujmuje to specyfikacja, "a CORS preflight is made and the server needs to first allow such requests by returning the appropriate set of CORS headers: Access-Control-Allow-Credentials, Access-Control-Allow-Origin, Access-Control-Allow-Headers." Preflight podwaja liczbę podróży w obie strony na stronie, która właśnie się zamyka, więc wysyłaj JSON jako zwykły ciąg znaków i parsuj go po stronie serwera.
![]()
Dlaczego beacon powinien się uruchamiać przy pagehide, a nie unload?
Wysyłaj beacon najpierw przy visibilitychange, potem przy pagehide, a unload zostaw w spokoju, bo psuje on pamięć podręczną wstecz/dalej. Strona MDN o sendBeacon mówi to jasno: "the unload event is incompatible with the back/forward cache (bfcache) implemented in modern browsers. Some browsers, such as Firefox, handle this incompatibility by excluding pages from the bfcache if they contain unload handlers, thus hurting performance." MDN zaleca pagehide jako rozwiązanie zapasowe dla przeglądarek bez visibilitychange: "Like beforeunload and unload, this event is not reliably fired, especially on mobile. However, it is compatible with the bfcache."
Specyfikacja Beacon dodaje powód związany z urządzeniami mobilnymi: "Developers should avoid relying on unload event because it will not fire whenever a page is in a background state (i.e. visibilityState equal to hidden) and the process is terminated by the mobile OS." Pełne porównanie zdarzeń wyjścia znajdziesz w tekście beforeunload a pagehide.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Jak napisać wywołanie sendBeacon, które przetrwa zamknięcie strony?
Przekaż zwykły ciąg znaków, sprawdź zwróconą wartość logiczną i wyczyść bufor dopiero wtedy, gdy przeglądarka przyjmie dane do kolejki:
const endpoint = 'https://collect.example.com/session';
const buffer = { sessionId: crypto.randomUUID(), events: [] };
function flush() {
if (buffer.events.length === 0) return;
const body = JSON.stringify(buffer);
if (navigator.sendBeacon(endpoint, body)) {
buffer.events.length = 0;
}
}
document.addEventListener('visibilitychange', () => {
if (document.visibilityState === 'hidden') flush();
});
window.addEventListener('pagehide', flush);Treść tekstowa daje text/plain;charset=UTF-8, który jest na liście dozwolonych, więc żądanie POST między źródłami pomija preflight. Zwrócone false oznacza, że dane razem ze wszystkim, co jest w toku, przekroczyły 65 536 bajtów, a bufor zostaje na kolejną próbę.
Jak napisać to samo wywołanie z fetch keepalive?
Ustaw keepalive: true, dodaj nagłówki, których sendBeacon nie przeniesie, i pogódź się z tym, że obietnica zostanie rozwiązana tylko wtedy, gdy strona dotrwa do tego momentu:
window.addEventListener('pagehide', () => {
fetch('https://collect.example.com/session', {
method: 'POST',
keepalive: true,
headers: {
'Content-Type': 'application/json',
'X-Api-Key': apiKey,
},
body: JSON.stringify(buffer),
}).catch(() => {});
});Zarówno Content-Type: application/json, jak i własny nagłówek X-Api-Key są poza listą dozwolonych CORS, więc wywołanie między źródłami uruchamia preflight OPTIONS i wymaga Access-Control-Allow-Headers na serwerze. Jedno ograniczenie dotyczy wyłącznie keepalive: algorytm extract-a-body ze standardu Fetch zgłasza TypeError dla treści typu ReadableStream, gdy flaga jest ustawiona, więc strumieniowanie przy wyjściu odpada. Właśnie ten moment wyjścia sprawia, że lekki skrypt jest wart swojej ceny i że narzut wydajnościowy odtwarzania sesji ujawnia się przy wysyłce, a nie przy nagrywaniu.
Którego użyć?
Używaj sendBeacon do analityki typu „wyślij i zapomnij”, a fetch keepalive zawsze wtedy, gdy liczy się nagłówek, metoda lub odpowiedź.
| Wymaganie | sendBeacon | fetch keepalive |
|---|---|---|
| Metoda HTTP | Tylko POST | Dowolna metoda |
| Własne nagłówki żądania | Brak obsługi | Obsługiwane |
| Kontrola Content-Type | Wynika z typu treści | Ustawiasz samodzielnie |
| Odpowiedź serwera | Niedostępna | Odczyt przez obietnicę |
| Rozmiar treści | Wspólny budżet 64 KiB | Ten sam budżet |
| Dostępność w service workerach | Nie | Tak |
Powyżej 64 kibibajtów nie działa żaden z nich: próbkuj dane, dziel je albo przenieś agregację na serwer, o czym piszemy w tekście analityka po stronie klienta a po stronie serwera.
![]()
Najczęściej zadawane pytania
Czy wartość true zwrócona przez sendBeacon oznacza, że serwer otrzymał dane?
Nie. Specyfikacja Beacon podaje, że zwrócone true "implies the browser has queued the data for transfer" oraz że "since the actual data transfer happens asynchronously, this method does not provide any information whether the data transfer has succeeded or not." Jedynym innym sygnałem jest false, które oznacza, że kolejka odrzuciła dane.
Czy mogę ustawić nagłówek Authorization w sendBeacon?
Nie. Specyfikacja Beacon stwierdza, że sendBeacon "does not provide ability to customize the request method, provide custom request headers, or change other processing properties of the request and response." Przenieś dane uwierzytelniające do ścieżki URL, pliku cookie lub treści albo przejdź na fetch() z keepalive: true.
Dlaczego Blob w sendBeacon wywołuje preflight CORS?
Bo type obiektu Blob staje się nagłówkiem Content-Type żądania, a application/json nie ma na liście dozwolonych CORS. Standard Fetch ogranicza tę listę do application/x-www-form-urlencoded, multipart/form-data i text/plain, więc wszystko inne wymusza preflight OPTIONS. Wyślij JSON jako ciąg znaków, a żądanie zostanie w trybie no-cors.
Czy limit 64 KiB dotyczy żądania, czy strony?
Grupy fetch, czyli wszystkich niezakończonych w niej żądań keepalive. Standard Fetch sumuje contentLength nowej treści z inflightKeepaliveBytes i po przekroczeniu 64 kibibajtów zwraca błąd sieciowy, więc duży beacon w toku zmniejsza miejsce dla następnego.
Czy fetch keepalive działa w service workerze?
Tak. MDN wymienia dostępność w service workerach jako przewagę fetch() z keepalive nad sendBeacon(), obok metod innych niż POST, własnych właściwości żądania i dostępu do odpowiedzi.
Co dzieje się z żądaniem keepalive, gdy użytkownik od razu zamknie kartę?
Przeglądarka utrzymuje żądanie dłużej niż dokument, który je rozpoczął, i po to właśnie jest ta flaga. Standard Fetch opisuje keepalive jako pozwalające "the request to outlive the environment settings object", a limit istnieje po to, by takie żądania "have a bounded size and are not allowed to stay alive indefinitely." Tracisz odpowiedź: obietnica nie ma już żywej strony, w której mogłaby się rozwiązać.
Czy sendBeacon może używać metod innych niż POST?
sendBeacon wysyła wyłącznie POST, co widać w tabeli porównawczej. fetch z keepalive przyjmuje dowolną metodę, więc przejdź na niego, gdy punkt końcowy oczekuje PUT, PATCH lub GET.
Dlaczego treść strumieniowa nie działa z fetch keepalive?
Algorytm extract-a-body ze standardu Fetch zgłasza TypeError dla treści typu ReadableStream, gdy keepalive jest ustawione, więc strumień nie może opuścić strony przy wyjściu. Zserializuj dane za pomocą JSON.stringify albo przekaż treść jako ciąg znaków.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Czy nasłuchiwać pagehide i visibilitychange razem, czy wybrać jedno?
Wysyłaj najpierw przy visibilitychange, bo wychwytuje przejście karty w tło jeszcze przed zamknięciem strony, a pagehide dodaj jako rozwiązanie zapasowe dla przeglądarek, w których visibilitychange nie działa niezawodnie. Funkcja flush z przykładu w tym artykule podpina oba nasłuchiwacze, a beacon wysyła ten, który zadziała pierwszy.
Co zrobić, gdy dane przekroczą 64 KiB?
Ani sendBeacon, ani fetch keepalive nie przeniosą treści większej niż 65 536 bajtów: po przekroczeniu wspólnego budżetu żądanie zwraca błąd sieciowy lub wynik false. Próbkuj dane, rozdziel je na kilka wysyłek albo przenieś agregację na serwer.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Dlaczego wybór między beforeunload a pagehide decyduje o danych analitycznych
Porównanie beforeunload i pagehide pokazuje, dlaczego urządzenia mobilne pomijają beforeunload, jak blokuje on bfcache i czemu pagehide z sendBeacon niezawodnie wysyła dane.


Co bfcache robi z nawigacją wstecz i liczbą odsłon
Bfcache, czyli pamięć podręczna wstecz/dalej, przywraca stronę z pamięci po kliknięciu wstecz lub dalej. Które strony się kwalifikują i dlaczego analityka je pomija lub liczy podwójnie.


Dlaczego CNAME cloaking nie ukrywa już trackerów przed Safari i Brave
CNAME cloaking pozwalał trackerom udawać twoją subdomenę. Zobacz, jak działa ta sztuczka DNS, czemu Safari tnie cookies do 7 dni i jak demaskują ją Brave i uBlock.


Jak cookie syncing dopasowuje identyfikatory reklamowe między witrynami
Firmy adtech wymieniają identyfikatory przez przekierowania i piksele. Zobacz, co robią z tym Safari, Firefox i Chrome oraz czemu analityka tego nie potrzebuje.


Jak budować wskaźniki obliczane w GA4 przy limicie pięciu miejsc
Google ogranicza wskaźniki obliczane w GA4 do 5 na standardową usługę. Poznaj składnię wzorów, jednostki, miejsca użycia i to, czego wzór nie może zawierać.


Grupowanie treści w GA4 za pomocą jednego parametru
Skonfiguruj grupowanie treści w GA4 parametrem content_group w gtag lub Tag Managerze, odczytaj wymiar Content group i pozbądź się wierszy (not set).
Powiązane artykuły


Jak dodawać adnotacje Google Analytics w GA4 i prowadzić rejestr zmian
Adnotacje Google Analytics w GA4 przypinają datowaną notatkę do wykresów liniowych. Kto może je dodawać, limity 60 i 150 znaków, pułap 1 000 i rejestr zmian.


Jak działa opt-out z Google Analytics i co blokuje każda metoda
Opt-out z Google Analytics to dodatek do przeglądarki, flaga ga-disable w window lub odmowa zgody. Co każda metoda blokuje, kto nią steruje i gdzie się kończy.


Jak Google tag gateway serwuje tag Google z twojej własnej domeny
Z Google tag gateway tag Google ładuje się z twojej domeny, a żądania przechodzą przez twój CDN. Co to zmienia w dokładności danych i jak to skonfigurować.