Narzędzie do udostępniania tekstu (pastebin)

Narzędzie do udostępniania tekstu, często nazywane pastebinem, to strona internetowa służąca do umieszczania bloku tekstu lub kodu i otrzymywania linku, który pokazuje ten tekst każdemu, kto go otworzy. To narzędzie pastebin działa w całości w przeglądarce, nie wymaga konta i może opcjonalnie dodawać kolorowanie składni oraz czas wygaśnięcia linku.

Jak działa narzędzie do udostępniania tekstu

Większość usług pastebin przechowuje tekst na serwerze i zwraca krótki link wskazujący wiersz w bazie danych. To narzędzie działa inaczej. Nie ma serwera ani bazy danych. Zamiast tego umieszcza cały wklejony tekst bezpośrednio w linku.

Gdy ktoś kliknie „Utwórz link”, narzędzie wykonuje cztery czynności:

1. Tworzy niewielki obiekt zawierający tekst, wybrany język i czas wygaśnięcia (albo nic — w przypadku opcji „nigdy”).
2. Konwertuje ten obiekt na jeden wiersz tekstu w formacie JSON.
3. Zamienia JSON na bajty przy użyciu kodowania UTF-8, używanego w całym internecie.
4. Koduje te bajty jako base64url — schemat zamieniający dowolne bajty na litery, cyfry, - i _, dzięki czemu wynik jest bezpieczny wewnątrz adresu URL.

Zakodowany tekst jest umieszczany po #p= na końcu adresu URL strony. Wszystko po # nazywa się fragmentem. Przeglądarka nigdy nie wysyła fragmentu do serwera podczas wczytywania strony, więc treść wklejonego tekstu nie jest nigdzie przesyłana. Odczytanie danych z linku przebiega w odwrotnej kolejności: dekoduje się tekst base64url, zamienia bajty z powrotem na ciąg JSON przy użyciu UTF-8, a następnie analizuje JSON, aby odzyskać tekst, język i czas wygaśnięcia.

Ponieważ fragment zawiera cały wklejony tekst, link udostępniony działa na dowolnym urządzeniu lub w dowolnej przeglądarce, a nie tylko na tym, na którym został utworzony. Nie trzeba niczego wyszukiwać. Wystarczy otworzyć link, aby wyświetlić treść — podobnie jak otwarcie pobranego pliku nie wymaga pytania serwera o jego zawartość.

Dla wygody narzędzie przechowuje również lokalną kopię każdego wklejonego tekstu w pamięci przeglądarki jako wersję roboczą. Ta kopia pomaga tylko tej samej przeglądarce ponownie znaleźć własne, wcześniej utworzone wklejone teksty; nie ma żadnego wpływu na otwieranie udostępnionego linku. Jej usunięcie nie powoduje uszkodzenia żadnego linku, ponieważ link nigdy od niej nie zależał.

Kolorowanie składni

Kolorowanie składni nadaje kolory częściom kodu, takim jak słowa kluczowe, ciągi znaków i komentarze, dzięki czemu jego struktura jest łatwiejsza do odczytania. Narzędzie obsługuje dziesięć opcji:

• Zwykły tekst (bez kolorowania)
• JavaScript
• TypeScript
• Python
• Java
• HTML
• CSS
• JSON
• SQL
• Bash

Wybrany język jest przechowywany w zakodowanym ładunku, więc kolorowanie jest stosowane automatycznie po otwarciu linku, bez konieczności wybierania czegokolwiek przez osobę przeglądającą treść.

Wzór obliczania wygaśnięcia

Opcja wygaśnięcia ustawia bezwzględny znacznik czasu mierzony w milisekundach od 1 stycznia 1970 — powszechnego w informatyce punktu odniesienia zwanego epoką uniksową. Narzędzie dodaje do chwili utworzenia linku ustalony okres:

Na przykład jeśli link zostanie utworzony, gdy zegar wskazuje 1 700 000 000 000 ms, a twórca wybierze opcję „1 tydzień”, zapisany czas wygaśnięcia wyniesie:

1 700 000 000 000 + (7 × 24 × 60 × 60 × 1 000) = 1 700 604 800 000 ms

Gdy osoba przeglądająca otworzy link, narzędzie porównuje zapisany znacznik czasu z bieżącym czasem. Jeśli zapisany czas już minął, narzędzie wyświetla komunikat „Ta treść wygasła” zamiast tekstu. Ponieważ znacznik czasu wygaśnięcia jest przesyłany wewnątrz linku razem z tekstem, to sprawdzenie działa tak samo na każdym urządzeniu.

jak wklejony tekst staje się linkiem

Załóżmy, że ktoś udostępnia zwykły tekst Hello, world! bez terminu wygaśnięcia. Narzędzie tworzy następujący obiekt JSON, używając krótkich nazw pól, aby zachować zwięzłość linku:

Koduje ten JSON jako bajty UTF-8, a następnie jako base64url, uzyskując:

Pełny link udostępniania to adres strony oraz ten token po #p=:

Każdy, kto otworzy ten link, korzysta z przeglądarki, która dekoduje token, odczytuje Hello, world! jako zwykły tekst i wyświetla go. Żaden serwer nie musiał niczego dostarczać.

Jak udostępniać tekst lub kod

1. Wpisz tekst w polu tekstowym albo wklej go do niego. Licznik znaków aktualizuje się podczas wpisywania tekstu.
2. Opcjonalnie wybierz język z menu kolorowania składni.
3. Opcjonalnie wybierz, jak długo link ma pozostać ważny.
4. Kliknij „Utwórz link”.
5. Skopiuj wygenerowany link za pomocą przycisku „Kopiuj link” i wyślij go w wybrany sposób.

Jak wyświetlać udostępniony tekst

1. Otwórz udostępniony link.
2. Tekst pojawi się natychmiast, z kolorowaniem, jeśli wybrano język.
3. Użyj opcji „Kopiuj tekst”, aby skopiować treść do schowka.
4. Użyj opcji „Utwórz nowy”, aby rozpocząć nowe wklejanie.

Wklejonego tekstu nie można edytować po utworzeniu linku. Zmiana tekstu wymaga utworzenia nowego wklejenia i udostępnienia nowego linku.

Typowe zastosowania

• Programiści udostępniający fragment kodu do przeglądu lub w celu uzyskania pomocy w debugowaniu.
• Nauczyciele udostępniający kod początkowy lub instrukcje.
• Każdy, kto przenosi blok tekstu, taki jak lista lub zestaw notatek, między dwoma własnymi urządzeniami.

W przypadku tekstu, który ma pozostać edytowalny jednocześnie przez kilka osób, lepiej sprawdzi się narzędzie do współdzielonych dokumentów. W przypadku kodu wymagającego trwałej historii zmian lepszy będzie system kontroli wersji, taki jak Git.

Ograniczenia i prywatność

Ponieważ cały wklejony tekst znajduje się w linku, praktycznym ograniczeniem rozmiaru jest długość samego adresu URL, a nie limit pamięci. Przeglądarki mogą obsługiwać długie adresy URL, ale wiele programów pocztowych, aplikacji do czatowania i starszych systemów skraca lub odrzuca bardzo długie adresy, dlatego wyjątkowo duże wklejone teksty mogą nie przechodzić poprawnie każdym kanałem. Krótkie i średniej długości wklejenia nie są tym ograniczeniem dotknięte.

Fragment nigdy nie jest wysyłany do serwera, więc samo narzędzie nigdy nie dowiaduje się, co zostało wklejone. Każdy, kto ma dokładny link, może go otworzyć, dlatego link należy traktować tak samo jak zawarty w nim tekst: nie należy w ten sposób udostępniać haseł ani innych poufnych danych i nie należy publikować linku w miejscu dostępnym publicznie, jeśli treść ma pozostać prywatna.

Często zadawane pytania

Gdzie faktycznie jest przechowywany udostępniony tekst? Nie jest przechowywany nigdzie poza linkiem. Tekst, wybrany język i czas wygaśnięcia są zakodowane bezpośrednio we fragmencie linku, czyli w części po #. Link jest jedyną kopią.

Czy link działa na innym urządzeniu lub w innej przeglądarce? Tak. Ponieważ treść jest przesyłana wewnątrz linku, każde urządzenie, które go otworzy, może ją zdekodować i wyświetlić. Konto ani pierwotna przeglądarka nie są wymagane.

Co się stanie po wyczyszczeniu danych przeglądarki? Istniejącym linkom udostępniania nic się nie stanie. Nie zależą one od niczego przechowywanego w przeglądarce, lecz tylko od samego linku. Wyczyszczenie danych przeglądarki usuwa jedynie lokalną kopię wklejonych tekstów utworzonych na tym urządzeniu, przechowywaną dla wygody.

Czy można edytować wklejony tekst po utworzeniu linku? Nie. W przypadku każdej zmiany trzeba utworzyć nowy link, ponieważ treść zostaje zapisana w linku w chwili jego tworzenia.

Co się dzieje po wygaśnięciu wklejonego tekstu? Otwarcie wygasłego linku powoduje wyświetlenie komunikatu o wygaśnięciu treści zamiast pierwotnego tekstu. Sam link nadal istnieje; po prostu nie wyświetla już treści, gdy minie zapisany czas wygaśnięcia.

Czy istnieje limit rozmiaru? Nie ma stałego limitu przechowywania, ale niektóre programy pocztowe i aplikacje do przesyłania wiadomości mogą odrzucać lub skracać bardzo długie adresy URL, dlatego bardzo duże wklejone teksty lepiej udostępniać za pomocą przeznaczonego do tego narzędzia do udostępniania plików.

Piśmiennictwo

1. "UTF-8." Dokumentacja MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/UTF-8
2. "Base64." Dokumentacja MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Glossary/Base64
3. "URL." Dokumentacja MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/API/URL
4. "Syntax highlighting." Wikipedia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Syntax_highlighting
5. "Unix time." Wikipedia, Wikimedia Foundation, https://en.wikipedia.org/wiki/Unix_time