1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
---
title: nsIConsoleService
slug: nsIConsoleService
tags:
- Dokumentacja_API_XPCOM
- Interfejsy
- 'Interfejsy:Scriptable'
- Wszystkie_kategorie
- XPCOM
translation_of: Mozilla/Tech/XPCOM/Reference/Interface/nsIConsoleService
---
<p>
</p>
<h3 id="Podsumowanie" name="Podsumowanie"> Podsumowanie </h3>
<p>Usługa konsoli to back-end dla narzędzia <a href="pl/Konsola_b%c5%82%c4%99d%c3%b3w">Konsola błędów</a>, dostępnym w każdej aplikacji Mozilli. Wykorzystywany jest do wypisywania różnych wiadomości, ostrzeżen i błędów oraz do ich pobierania.
</p><p>Definicja interfejsu: {{ Source("xpcom/base/nsIConsoleService.idl") }}
Identyfikator kontraktu: <code>@mozilla.org/consoleservice;1</code>
</p><p>Interfejs ten nie został zamrożony i może ulec zmianie w przyszłości ({{ Bug(228205) }}).
</p>
<h3 id="Przyk.C5.82ady" name="Przyk.C5.82ady"> Przykłady </h3>
<h4 id="Zapisywanie_prostej_wiadomo.C5.9Bci_w_dzienniku" name="Zapisywanie_prostej_wiadomo.C5.9Bci_w_dzienniku"> Zapisywanie prostej wiadomości w dzienniku </h4>
<p>Typowe zastosowanie to zapisywanie wiadomości do konsoli:
</p>
<pre class="eval">function LOG(msg) {
var consoleService = Components.classes["@mozilla.org/consoleservice;1"]
.getService(Components.interfaces.nsIConsoleService);
consoleService.logStringMessage(msg);
}
</pre>
<p>Alternatywne metody to m. in. <a href="pl/Components.utils.reportError">Components.utils.reportError</a> i <a href="pl/DOM/window.dump">dump()</a>.
</p>
<h4 id="Zapisywanie_do_dziennika_wiadomo.C5.9Bci_z_dodatkowymi_informacjami" name="Zapisywanie_do_dziennika_wiadomo.C5.9Bci_z_dodatkowymi_informacjami"> Zapisywanie do dziennika wiadomości z dodatkowymi informacjami </h4>
<p>Aby dołączyć inne informacje, takie jak plik żródłowy i numer linii, konieczne jest skorzystanie z bardziej skomplikowanego kodu:
</p>
<pre class="eval">function myLogToConsole(aMessage, aSourceName, aSourceLine, aLineNumber,
aColumnNumber, aFlags, aCategory)
{
var consoleService = Components.classes["@mozilla.org/consoleservice;1"]
.getService(Components.interfaces.nsIConsoleService);
var scriptError = Components.classes["@mozilla.org/scripterror;1"]
.createInstance(Components.interfaces.nsIScriptError);
scriptError.init(aMessage, aSourceName, aSourceLine, aLineNumber,
aColumnNumber, aFlags, aCategory);
consoleService.logMessage(scriptError);
}
</pre>
<ul><li><code>aMessage</code> — tekst do zapisania w dzienniku. Parametr wymagany.
</li><li><code>aSourceName</code> — adres URL pliku z błędem. W konsoli będzie to odnośnik, więc powinien to być prawdziwy adres URL. Można także przekazać wartość <code>null</code>, jeśli wskazanie pliku żródła nie jest potrzebne/możliwe.
</li><li><code>aSourceLine</code> — linia #<code>aLineNumber</code> z pliku <code>aSourceName</code>. Za dostarczenie tej linii odpowiada programista. Można także przekazać <code>null</code>, wówczas linia żródła nie zostanie wyświetlona w konsoli błędów.
</li><li><code>aLineNumber</code> i <code>aColumnNumber</code> — określa dokładne położenie błędu. <code>aColumnNumber</code> wykorzystywany jest do wskazania strzałką problematycznego znaku.
</li><li><code>aFlags</code> — jedna z flag określonych w <code>nsIScriptError</code>. W momencie tworzenia tego artykułu dostępnymi wartościami były: <code>nsIScriptError.errorFlag = 0</code>, <code>nsIScriptError.warningFlag = 1</code>, <code>nsIScriptError.exceptionFlag = 2</code> i <code>nsIScriptError.strictFlag = 4</code>.
</li><li><code>aCategory</code> — tekst określający rodzaj kodu, który spowodował dany błąd. Istnieje kilka kategorii, ale nie ma jednego miejsca, w którym można by znależć je wszystkie. Mamy nadzieję, że kiedyś znajdą się w <tt>nsIScriptError.idl</tt>.<span class="comment">tlumaczyc to?</span>
</li></ul>
{{ languages( { "fr": "fr/NsIConsoleService", "ja": "ja/NsIConsoleService", "en": "en/NsIConsoleService" } ) }}
|
