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
|
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
* vim: set ts=8 sts=2 et sw=2 tw=80:
* 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/. */
#ifndef js_DOMEventDispatch_h
#define js_DOMEventDispatch_h
#include "js/TypeDecls.h"
namespace JS {
/**
* Callback type for DOM event dispatching from SpiderMonkey.
*
* Current events dispatched include JIT compilation steps during instantiation:
* - "omt_eager_baseline_function" when functions are queued for compilation
* - "omt_eager_baseline_dispatch" when compilation batches are sent
*
* Function names are appended when available (e.g.,
* "omt_eager_baseline_function: myFunc").
* Anonymous functions appear without names.
*/
typedef void (*DispatchDOMEventCallback)(JSContext* cx, const char* eventType);
/**
* Set the DOM event dispatch callback for embedders.
* Allows embedders to observe internal SpiderMonkey operations for
* testing/debugging. Pass nullptr to clear the callback.
*/
extern JS_PUBLIC_API void SetDispatchDOMEventCallback(
JSContext* cx, DispatchDOMEventCallback callback);
} /* namespace JS */
namespace js {
/**
* Internal function to dispatch DOM events for testing.
* Calls the registered DispatchDOMEventCallback if available.
*/
extern void TestingDispatchDOMEvent(JSContext* cx, const char* eventType);
/**
* Internal function to dispatch DOM events with optional function information.
*
* Behavior:
* - If script is nullptr or lacks function: dispatches basic eventType
* - If function name extraction succeeds: dispatches "eventType: functionName"
* - If function name extraction fails: does nothing and returns.
*/
extern void TestingDispatchDOMEvent(JSContext* cx, const char* eventType,
JSScript* script);
} /* namespace js */
/**
* Convenience macro for internal testing event dispatch.
* Supports both basic form and optional script parameter for function names.
*/
#define TRACE_FOR_TEST_DOM(cx, str, ...) \
do { \
js::TestingDispatchDOMEvent(cx, str, ##__VA_ARGS__); \
} while (0)
#endif /* js_DOMEventDispatch_h */
|
