path: root/files/pl/qa/wskazowki_do_zglaszania_bledow/index.html

---
title: Wskazówki do zgłaszania błędów
slug: QA/Wskazowki_do_zglaszania_bledow
tags:
  - Bugzilla
  - QA
  - Raport błędu
translation_of: Mozilla/QA/Bug_writing_guidelines
---
<div class="note">
<p><strong>Jeśli potrzebujesz pomocy z oprogramowaniem Mozilla (na przykład z Firefox, Seamonkey lub Thunderbird) skorzystaj z dostępnych <a href="http://www.mozilla.org/support/">tematów pomocy</a>.</strong> Nie edytuj tej strony!</p>
</div>

<p><span class="seoSummary">Ta strona zakłada, że chcesz wspomóc projekt Mozilla poprzez zebranie odpowiednich informacji, aby stworzyć użyteczny raport błędu w Bugzilla, systemie śledzenia błędów produktów Mozilla.</span> Dziękujemy!</p>

<p>Jeśli to twój pierwszy raport błędów, z pewnością zechcesz skorzystać z pomocy bardziej doświadczonych osób, które już wiedzą na czym to polega. Wskazówki znajdziesz na stronie <a href="/pl/docs/QA">QA</a> w sekcji Społeczność. Jeśli chcesz zgłosić błąd programu Firefox, pomoc znajdziesz również na kanale <span style="font-family: monospace;">#firefox</span> na <a href="irc://irc.mozilla.org/firefox">irc.mozilla.org</a>. Lista kanałów dla pozostałych projektów (np. Thunderbird lub SeaMonkey) znajduje się na naszej stronie wiki <a href="https://wiki.mozilla.org/IRC">IRC</a>.</p>

<h2 id="Jak_zgłosić_błąd">Jak zgłosić błąd</h2>

<h3 id="Dla_każdego_problemu_stwórz_osobny_raport!">Dla każdego problemu stwórz osobny raport!</h3>

<p>Zarządzanie statusem każdego z problemów z osobna jest dużo efektywniejsze.</p>

<h3 id="Inne_istotne_detale">Inne istotne detale</h3>

<ol>
 <li>Spróbuj określić <strong>kroki, które pozwalają zreprodukować błąd</strong>:

  <ul>
   <li>Jeśli wiesz jakie <a href="#steps_to_reproduce">dokłanie kroki należy podjąć</a> — świetnie! — jesteś na dobrej drodze, żeby zgłosić użyteczny raport błędu.</li>
   <li>Jeśli błąd potrafisz odtworzyć tylko sporadycznie (nie znasz dokładnych kroków), to aby raport był użyteczny należy podać <a href="#additional_info">dodatkowe informacje</a>.</li>
   <li>Jeśli nie potrafisz odtworzyć problemu, to zgłaszanie raportu prawdopodobnie nic nie da, chyba że bardzo szegółowo opiszesz sytuację, w której problem wystąpił.</li>
  </ul>
 </li>
 <li>Upewnij się, że twoje oprogramowanie jest aktualne. Byłoby idealnie przetestować nieoficjalną wersję (np. <a href="http://www.mozilla.com/pl/firefox/channel/">Firefox Beta, Aurora</a>, lub zawsze najświeższą <a class="link-https" href="https://nightly.mozilla.org/">Nightly</a>), żeby sprawdzić, czy przypadkiem twój błąd nie został już naprawiony.</li>
 <li>Zgłaszając błąd w Firefox, najpierw sprawdź czy potrafisz go odtworzyć <a href="https://support.mozilla.org/pl/kb/zarzadzanie-profilami">po stworzeniu nowego profilu Firefox</a>. Jeśli błąd pojawia się tylko w aktualnie używanym profilu, spróbuj znaleźć które <a href="https://support.mozilla.org/pl/kb/rozwiazywanie-problemow-z-rozszerzeniami-i-motywami">ustawienia, rozszerzenia</a> lub <a href="https://support.mozilla.org/pl/kb/Profile">pliki profilu</a> są potrzebne do zreprodukowania błędu.
  <ul>
   <li>Jeśli błąd wydaje się być skandaliczny (tj. dotyczy ogromnej liczby użytkowników) to możliwe, że w twojej instalacji jest coś nietypowego, co jest istotne podczas definiowania kroków do zreprodukowania błędu. Masz o wiele większe szanse domyślić się co to może być, niż programista który nie ma dostępu do twojego systemu.</li>
   <li>Jeśli błąd jest jednym ze <a href="#specific-types">specyficznych typów błędów (opisanych dalej)</a>, to taka informacja nadal będzie dla nas pomocna, nawet jeśli nie potrafisz określić kroków pozwalających zreprodukować błąd używając nowego profilu.</li>
  </ul>
 </li>
 <li>Otwórz <a class="link-https" href="https://bugzilla.mozilla.org/enter_bug.cgi?format=guided">formularz zgłaszania raportu błędu</a> (<em>w języku angielskim</em>), który poprowadzi cię przez większość procesu zgłaszania raportu błędu:
  <ul>
   <li>Utwórz konto w Bugzilla, jeśli jeszcze go nie masz, oraz wybierz produkt, dla którego chciałbyś stworzyć raport błędu.</li>
   <li>Napisz <strong>krótkie podsumowanie </strong>opisujące na czym polega błąd, tak jak <a href="#summary">opisano poniżej</a>; sprawdź czy taki błąd już nie został wcześniej zgłoszony (jeśli chcesz być bardziej dokładny, możesz skożystać z zaawansowanego przewodnika <a href="https://developer.mozilla.org/en-US/docs/Mozilla/QA/Screening_duplicate_bugs">wykrywania duplikatów błędów</a>).</li>
   <li>Podaj <strong>dokładne kroki do zreprodukowania błędu, oczekiwane zachowanie aplikacji </strong>oraz <strong>aktualne zachowanie aplikacji</strong>, tak jak <a href="#steps_to_reproduce">opisano poniżej</a>.</li>
   <li>Podaj dodatakowe informacje (również <a href="#additional_info">opisane poniżej</a>), szczególnie jeśli nie potrafisz zreprodukować błędu używając nowego profilu; oraz/lub przez zgłoszenie problemu związanego z <strong>nagłym zamknięciem aplikacji, zużyciem pamięci, wydajnością</strong> lub<strong> </strong>jest to <strong>błąd regresywny</strong>; lub masz problem związany z konkretną stroną internetową.</li>
  </ul>
 </li>
 <li>Jeśli chciałbyś zgłosić kilka problemów, stwórz proszę osobny raport dla każdego z osobna.</li>
</ol>

<h2 id="Pisanie_dobrego_podsumowania"><a id="summary" name="summary">Pisanie dobrego podsumowania</a></h2>

<p>Jak opisać błąd używając około 10 słów? Będzie to pierwsze co w twoim raporcie zobaczy programista.</p>

<p>Dobre podsumowanie powinno krótko i zwięźle identyfikować raport błędu. Powinno wyjaśniać na czym polega problem, nie proponowane rozwiązanie.</p>

<ul>
 <li>Dobrze: "Anulowanie w okienku kopiowania powoduje, że menedżer plików się wywala"</li>
 <li>Źle: "Program się wywala"</li>
</ul>

<ul>
 <li>Dobrze: "Przewijanie strzałką w dół nie działa w &lt;textarea&gt; ze stylem overflow:hidden"</li>
 <li>Źle: "Przeglądarka powinna współpracować z moją stroną"</li>
</ul>

<h2 id="Kroki_pozwalające_zreprodukować_błąd"><a id="steps_to_reproduce" name="steps_to_reproduce">Kroki pozwalające zreprodukować błąd</a></h2>

<p>Jak programista ma zreprodukować błąd na swoim komputerze?</p>

<p>Kroki pozwalające zreprodukować błąd są <strong>najważniejszą częścią każdego raportu błędu</strong>. Jeśli programista będzie w stanie zreprodukować błąd, to bardzo możliwe że uda się go rozwiązać. Jeśli kroki opiszesz w niejasny sposób, to może się okazać że nawet nie będzie wiadomo czy błąd został poprawiony.</p>

<table class="standard-table">
 <tbody>
  <tr>
   <th>Co powinien zawierać raport błędu?</th>
   <th>Dobry przykład (szczegółowy)</th>
   <th>Zły przykład (zbyt ogólnie)</th>
  </tr>
  <tr>
   <td>Opisz czy jesteś w stanie zreprodukować kroki i jak często (zawsze / czasami / w ogóle).</td>
   <td>Błąd potrafię zreprodukować wykonując następujące kroki:</td>
   <td> </td>
  </tr>
  <tr>
   <td>
    <p>W każdym kroku dodatkowo opisz sposoby interakcji z Firefox'em.</p>
   </td>
   <td>
    <p>1. Uruchom Firefox przez kliknięcie na ikonie pulpitu<br>
     2. Wciśnij Cmd+N (lub Ctrl+N w przypadku użytkowników Windows) aby otworzyć nowe okno przeglądarki<br>
     3. Wklej <a class="link-https" href="https://mail.google.com/" rel="freelink">https://mail.google.com/</a> w pasku adresu i wciśnij Enter</p>
   </td>
   <td>Otwórz Gmail w innym oknie</td>
  </tr>
  <tr>
   <td>
    <p>Po opisie kroków, dokładnie opisz <strong>obserwowane (aktualne)</strong> oraz <strong>oczekiwane zachowanie aplikacji</strong>. Jasno oddziel fakty (obserwacje) od przypuszczeń.</p>
   </td>
   <td><strong>Oczekiwane zachowanie:</strong> Moja skrzynka odbiorcza wyświetla się prawidłowo.<br>
    <strong>Aktualne zachowanie</strong>: Moja skrzynka odbiorcza wyświetla komunikat 'Twoja przeglądarka nie wspiera cookies (error -91)'.</td>
   <td>
    <p>"Nie działa"</p>

    <p>"Strona wyświetla się nieprawidłowo"</p>
   </td>
  </tr>
 </tbody>
</table>

<h2 id="Podawanie_dodatkowych_informacji"><a name="additional_info">Podawanie dodatkowych informacji</a></h2>

<p>Poniższe informacje są wymagane w przypadku większości raportów błędu. Możesz oszczędzić czas podając te informacje zaraz po Oczekiwanym zachowaniu aplikacji. Jeśli musisz dołączyć więcej niż jeden plik, będzie to możliwe później, po wysłaniu raportu.</p>

<h3 id="Specyficzne_typy_błędów"><a name="specific-types">Specyficzne typy błędów</a></h3>

<p>Jeśli wysyłasz raport dotyczący nagłego zamknięcia aplikacji (<em>ang. crash bug</em>) dołącz <a href="/en-US/docs/How_to_get_a_stacktrace_for_a_bug_report">Breakpad ID lub stos wywołania (ang. stack trace)</a> oraz sygnaturę błędu (<em>ang. </em><em>crash </em><em>signature</em>) do podsumowania i pola <strong>Crash Signature</strong>.</p>

<p>Jeśli wysyłasz raport dotyczący <strong>wykorzystania lub wycieku pamięci</strong>, dołącz <a href="/pl/docs/Mozilla/Performance/about:memory">wynik about:memory</a>. Idealnie byłoby znaleźć kroki prowadzące do wzrostu zużycia na pozycjach w about:memory (nawet po kliknięciu przycisku "Minimize memory usage" na dole ekranu). Jeśli masz problem z odtworzeniem kroków, zajrzyj na stronę Firefox Support <a href="https://support.mozilla.org/pl/kb/duze-uzycie-pamieci">Duże użycie pamięci</a>. Jeśli jesteś programistą C++, <a href="/pl/docs/Mozilla/Performance">dostępne są bardziej precyzyjne narzędzia</a>.</p>

<p>Jeśli wysyłasz raport na temat <strong>powolnego działania aplikacji lub wysokiego użycia procesora</strong>, w raporcie podaj <a href="/pl/docs/Mozilla/Performance/Reporting_a_Performance_Problem">link do profilu wydajności</a>.</p>

<p>Jeśli <strong>aplikacja się zawiesza</strong> (piłka plażowa w OS X lub "Okno nie odpowiada" w Windows) postępuj według instrukcji z artykułu <a href="/en-US/docs/How_to_Report_a_Hung_Firefox">Jak zgłosić że Firefox się zawiesza</a>.</p>

<p>Jeśli wysyłasz raport dotyczący <strong>Zawieszającej się wtyczki Flash</strong> odwiedź<strong> </strong><a href="https://wiki.mozilla.org/Flash/Hang_Debugging">https://wiki.mozilla.org/Flash/Hang_Debugging</a> żeby dowiedzieć się jak wydobyć istotne informacje na ten temat dla programistów.</p>

<p>Jeśli wysyłasz raport <strong>błędu dotyczącego konkretnej strony insternetowej </strong>spróbuj przeprowadzić <a href="/en-US/docs/Reducing_testcases">skrócony przypadek testowy</a> i dołącz go do raportu. Jeśli nie masz na to czasu lub ekspertyzy na ten temat, to zamiast do nas zgłoś ten problem na <a href="https://webcompat.com/">webcompat.com</a>, gdzie nasi ochotnicy zrobią to za ciebie.</p>

<p>Jeśli <strong>błąd pojawił się niedawno</strong> to znalezienie <a href="https://mozilla.github.io/mozregression/quickstart.html">okna regresji</a> może pomóc nam zidentyfikować przyczynę problemu.</p>

<p><a href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html#intermittent">Co jeśli mój błąd wydaje się "przypadkowy" lub "sporadyczny"?</a> (<em>tekst angielski</em>)</p>

<h3 id="Większość_błędów_dotyczących_Firefox'a">Większość błędów dotyczących Firefox'a</h3>

<p>Większość raportów błędów dotyczących Firefox'a powinna zawierać poniższe informacje.</p>

<table class="standard-table">
 <tbody>
  <tr>
   <th>Co powinno się znaleźć w raporcie błędu?</th>
   <th>Przykład</th>
  </tr>
  <tr>
   <td>Sprawdzenie, czy problem można zreprodukować zakładając <a href="https://support.mozilla.org/pl/kb/zarzadzanie-profilami">nowy profil Firefox</a> i opisanie wszystkich zmian jakich należy dokonać aby zreprodukować błąd.</td>
   <td>Problem jest reprodukowalny w nowym profilu, ale jedynie gdy Opcje -&gt; Prywatność i bezpieczeństwo -&gt; Ochrona przed śledzeniem jest włączona.</td>
  </tr>
  <tr>
   <td>Jeśli błąd pojawia się tylko w aktualnie używanym profilu, spróbuj znaleźć które <a href="https://support.mozilla.org/pl/kb/rozwiazywanie-problemow-z-rozszerzeniami-i-motywami">ustawienia, rozszerzenia</a> lub <a href="https://support.mozilla.org/pl/kb/Profile">pliki profilu</a> są potrzebne do zreprodukowania błędu. Jeśli pominiesz ten krok, zapisz do pliku <a href="https://support.mozilla.org/pl/kb/informacje-dla-pomocy-technicznej-about-support">Informacje dla pomocy technicznej z about:support</a> i dołącz ten plik do raportu.</td>
   <td>Nie potrafię zreprodukować błędu na nowym profilu, dołączam informacje z about:support dotyczące profilu, na którym błąd występuje.</td>
  </tr>
  <tr>
   <td>
    <p>Spradź czy problem można zreprodukować przy użyciu <a href="https://nightly.mozilla.org/">najświeższej zbudowanej wersji Nightly</a>. Dołącz <strong>Build ID</strong> z <a href="https://support.mozilla.org/pl/kb/informacje-dla-pomocy-technicznej-about-support">about:support</a>.</p>

    <p>Jeśli to możliwe, test wykonaj na nowo stworzonym profilu Firefox. Jeśli musisz przetestować wersję Nightly twoim normalnie używanym profilem, wykonaj najpierw jego <a href="/pl/kb/Tworzenie%20kopii%20zapasowej%20swoich%20danych">kopię zapasową</a>, ponieważ tego typu wydania mogą uszkodzić twoje dane.</p>
   </td>
   <td>Problem pojawia się tylko na najnowszej wersji Nightly (Build ID 20170416100136).</td>
  </tr>
 </tbody>
</table>

<p> </p>

<div class="originaldocinfo">
<h2 id="Informacje_o_dokumencie">Informacje o dokumencie</h2>

<ul>
 <li>Autorzy: Jesse Ruderman, Gervase Markham</li>
 <li>Inni współtwórcy: Eli Goldberg, Claudius Gayle, Jan Leger, Felix Miata, Peter Mock, Chris Pratt, Chris Yeh, i inni.</li>
</ul>
</div>

<p> </p>

<hr>
<h2 id="Advanced">Advanced</h2>

<h3 id="Finding_the_correct_product_and_component" name="Finding_the_correct_product_and_component"><strong style="font-weight: bold;">Finding the correct product and component</strong></h3>

<p>You will be asked to categorize your bug into a "product" and a "component" within that product, in order to direct your report to the correct developers.</p>

<p>If you're using Firefox, the bug is most likely in "Firefox", "Toolkit", or "Core".</p>

<ul>
 <li><a class="link-https" href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Firefox">List of components in the "Firefox" product</a> - Most parts of Firefox that you interact with directly</li>
 <li><a class="link-https" href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Toolkit">List of components in the "Toolkit" product</a> - Interface widgets and some frontend features</li>
 <li><a class="link-https" href="https://bugzilla.mozilla.org/describecomponents.cgi?product=Core">List of components in the "Core" product</a> - Web page rendering, networking, etc.</li>
</ul>

<p>When in doubt, search for similar bugs and see which component they are in.</p>

<p>If none of the components seem appropriate, look for a "General" component in the most appropriate product.</p>

<h3 id="General_Outline_of_a_Bug_Report">General Outline of a Bug Report</h3>

<div class="note">
<p>Most of the following article has been merged into this page from QMO: How to write a proper bug</p>
</div>

<ul>
 <li><strong>Summary</strong>: How would you describe the bug in less than 60 characters? It should quickly and uniquely identify a bug report as well as explain the problem, not your suggested solution. Good: "Canceling a File Copy dialog crashes File Manager" Bad: "Software crashes" Bad: "Browser should work with my web site"</li>
 <li><strong>Component</strong>: In which sub-part of the software does it exist? This field is a requirement to submit any bug report. Click the word "Component" to see a description of each component. If none seems appropriate, highlight the "General" component.</li>
 <li><a name="version"> </a><strong>Version</strong>: select the earliest Version with what the problem can be reproduced:
  <ul>
   <li>Developers will use that information to narrow down the commit what introduced a regression</li>
   <li>QA staff needs that information to distinguish bugs with similar symptoms, but different roots.
    <ul>
     <li>Bugs that definitively appeared in different <em>Product</em> <em>Versions</em> probably will have different roots</li>
     <li>But Bugs that started with the same <em>Product</em> <em>Version</em> probably are DUPLICATEs</li>
    </ul>
   </li>
   <li><em>Trunk</em> does not allow any useful query. We have <em>Trunk</em> version bugs from beginning of the project until today, no common characteristics at all what can be tagged with this version. Avoid Trunk, replace it by precise information with what version the problem appeared if you can.</li>
  </ul>
 </li>
 <li><strong>OS</strong>: On which operating system (OS) did you find it? (E.g. Linux, Windows, and Mac.) Example: "<em>If you know the bug happens on more than one type of operating system, choose "All". If your OS isn't listed, choose Other".</em></li>
 <li><strong>Description</strong>: The details of your problem report, including:
  <ul>
   <li><u>Overview</u>: This is a larger detailed restatement of the summary. An example would be: <em>"Drag-selecting any page crashes Mac builds in the NSGetFactory function"</em>.</li>
   <li><u>Build Id</u>: To find this either go to the "about:support" page via the location bar or, if you have MozQA's <a href="https://addons.mozilla.org/en-US/firefox/addon/nightly-tester-tools/">Nightly Tester Tools</a> extension, then go to Tools | Nightly Tester Tools and select the option that contains the output of the build Id. It should look something like this: <em>"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:38.0) Gecko/20100101 Firefox/38.0 ID:20150330004006 CSet: 9e57e9776571"</em>.</li>
   <li><u>Additional Builds and Platforms</u>: Whether or not the bug takes place on other platforms (or browsers, if applicable). It should look something like this: <em>"Doesn't Occur On Mozilla/5.0 (Macintosh; Intel Mac OS X 10.10; rv:38.0) Gecko/20100101 Firefox/38.0 ID:20150330004006 CSet: 9e57e9776571"</em>.</li>
  </ul>
 </li>
 <li><strong>Steps to Reproduce</strong>: Minimized, easy-to-follow steps that will trigger the bug. If they're necessary, make sure to include any special setup steps. A good example of this would look like the following:<br>
  1) View any web page. (I used the default sample page, http://www.google.com/).<br>
  2) Drag-select the page. Specifically, while holding down the mouse button, drag the mouse pointer downwards from any point in the browser's content region to the bottom of the browser's content region.</li>
 <li><strong>Actual Results</strong>: What the application did after performing the above steps. An example would be: <em>The application crashed.</em></li>
 <li><strong>Expected Results</strong>: What the application should have done, were the bug not present. An example would be: <em>The window should scroll downwards. Scrolled content should be selected. Or, at least, the application should not crash.</em></li>
</ul>

<p> </p>

<div class="originaldocinfo">
<h4 id="Original_document_information">Original document information</h4>

<ul>
 <li>Author(s): Aakash Desai</li>
 <li>Date last modified: June 3, 2013 at 2:41 am PST</li>
</ul>
</div>