summaryrefslogtreecommitdiffstats
path: root/mobile/android/modules/geckoview/AndroidLog.sys.mjs
blob: f24e2bf899f72c26903c75bf5d3ff4fea59bc169 (plain)
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
/* -*- indent-tabs-mode: nil; js-indent-level: 2 -*-
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

/**
 * Native Android logging for JavaScript.  Lets you specify a priority and tag
 * in addition to the message being logged.  Resembles the android.util.Log API
 * <http://developer.android.com/reference/android/util/Log.html>.
 *
 * // Import it as a ESM:
 * let Log =
 *     ChromeUtils.importESModule("resource://gre/modules/AndroidLog.sys.mjs")
 *     .AndroidLog;
 *
 * // Use Log.i, Log.v, Log.d, Log.w, and Log.e to log verbose, debug, info,
 * // warning, and error messages, respectively.
 * Log.v("MyModule", "This is a verbose message.");
 * Log.d("MyModule", "This is a debug message.");
 * Log.i("MyModule", "This is an info message.");
 * Log.w("MyModule", "This is a warning message.");
 * Log.e("MyModule", "This is an error message.");
 *
 * // Bind a function with a tag to replace a bespoke dump/log/debug function:
 * let debug = Log.d.bind(null, "MyModule");
 * debug("This is a debug message.");
 * // Outputs "D/GeckoMyModule(#####): This is a debug message."
 *
 * // Or "bind" the module object to a tag to automatically tag messages:
 * Log = Log.bind("MyModule");
 * Log.d("This is a debug message.");
 * // Outputs "D/GeckoMyModule(#####): This is a debug message."
 *
 * Note: the module automatically prepends "Gecko" to the tag you specify,
 * since all tags used by Fennec code should start with that string; and it
 * truncates tags longer than MAX_TAG_LENGTH characters (not including "Gecko").
 */

import { ctypes } from "resource://gre/modules/ctypes.sys.mjs";

// From <https://android.googlesource.com/platform/system/core/+/master/include/android/log.h>.
const ANDROID_LOG_VERBOSE = 2;
const ANDROID_LOG_DEBUG = 3;
const ANDROID_LOG_INFO = 4;
const ANDROID_LOG_WARN = 5;
const ANDROID_LOG_ERROR = 6;

// android.util.Log.isLoggable throws IllegalArgumentException if a tag length
// exceeds 23 characters, and we prepend five characters ("Gecko") to every tag.
// However, __android_log_write itself and other android.util.Log methods don't
// seem to mind longer tags.
const MAX_TAG_LENGTH = 18;

var liblog = ctypes.open("liblog.so"); // /system/lib/liblog.so
var __android_log_write = liblog.declare(
  "__android_log_write",
  ctypes.default_abi,
  ctypes.int, // return value: num bytes logged
  ctypes.int, // priority (ANDROID_LOG_* constant)
  ctypes.char.ptr, // tag
  ctypes.char.ptr
); // message

export var AndroidLog = {
  MAX_TAG_LENGTH,
  v: (tag, msg) => __android_log_write(ANDROID_LOG_VERBOSE, "Gecko" + tag, msg),
  d: (tag, msg) => __android_log_write(ANDROID_LOG_DEBUG, "Gecko" + tag, msg),
  i: (tag, msg) => __android_log_write(ANDROID_LOG_INFO, "Gecko" + tag, msg),
  w: (tag, msg) => __android_log_write(ANDROID_LOG_WARN, "Gecko" + tag, msg),
  e: (tag, msg) => __android_log_write(ANDROID_LOG_ERROR, "Gecko" + tag, msg),

  bind(tag) {
    return {
      MAX_TAG_LENGTH,
      v: AndroidLog.v.bind(null, tag),
      d: AndroidLog.d.bind(null, tag),
      i: AndroidLog.i.bind(null, tag),
      w: AndroidLog.w.bind(null, tag),
      e: AndroidLog.e.bind(null, tag),
    };
  },
};