npm - apostrophe - Versions diffs - 2.220.6 → 2.221.0 - Mend

apostrophe 2.220.6 → 2.221.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (201) hide show

package/coverage/a3/modules/@apostrophecms/module/lib/events.js.html ADDED Viewed

@@ -0,0 +1,547 @@
+<!doctype html>
+<html lang="en">
+<head>
+    <title>Code coverage report for a3/modules/@apostrophecms/module/lib/events.js</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="../../../../../prettify.css" />
+    <link rel="stylesheet" href="../../../../../base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="../../../../../favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(../../../../../sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="../../../../../index.html">All files</a> / <a href="index.html">a3/modules/@apostrophecms/module/lib</a> events.js</h1>
+        <div class='clearfix'>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">93.1% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>54/58</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">87.5% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>28/32</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>7/7</span>
+            </div>
+            <div class='fl pad1y space-right2'>
+                <span class="strong">93.1% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>54/58</span>
+            </div>
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input oninput="onInput()" type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a>
+<a name='L39'></a><a href='#L39'>39</a>
+<a name='L40'></a><a href='#L40'>40</a>
+<a name='L41'></a><a href='#L41'>41</a>
+<a name='L42'></a><a href='#L42'>42</a>
+<a name='L43'></a><a href='#L43'>43</a>
+<a name='L44'></a><a href='#L44'>44</a>
+<a name='L45'></a><a href='#L45'>45</a>
+<a name='L46'></a><a href='#L46'>46</a>
+<a name='L47'></a><a href='#L47'>47</a>
+<a name='L48'></a><a href='#L48'>48</a>
+<a name='L49'></a><a href='#L49'>49</a>
+<a name='L50'></a><a href='#L50'>50</a>
+<a name='L51'></a><a href='#L51'>51</a>
+<a name='L52'></a><a href='#L52'>52</a>
+<a name='L53'></a><a href='#L53'>53</a>
+<a name='L54'></a><a href='#L54'>54</a>
+<a name='L55'></a><a href='#L55'>55</a>
+<a name='L56'></a><a href='#L56'>56</a>
+<a name='L57'></a><a href='#L57'>57</a>
+<a name='L58'></a><a href='#L58'>58</a>
+<a name='L59'></a><a href='#L59'>59</a>
+<a name='L60'></a><a href='#L60'>60</a>
+<a name='L61'></a><a href='#L61'>61</a>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a>
+<a name='L70'></a><a href='#L70'>70</a>
+<a name='L71'></a><a href='#L71'>71</a>
+<a name='L72'></a><a href='#L72'>72</a>
+<a name='L73'></a><a href='#L73'>73</a>
+<a name='L74'></a><a href='#L74'>74</a>
+<a name='L75'></a><a href='#L75'>75</a>
+<a name='L76'></a><a href='#L76'>76</a>
+<a name='L77'></a><a href='#L77'>77</a>
+<a name='L78'></a><a href='#L78'>78</a>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a>
+<a name='L81'></a><a href='#L81'>81</a>
+<a name='L82'></a><a href='#L82'>82</a>
+<a name='L83'></a><a href='#L83'>83</a>
+<a name='L84'></a><a href='#L84'>84</a>
+<a name='L85'></a><a href='#L85'>85</a>
+<a name='L86'></a><a href='#L86'>86</a>
+<a name='L87'></a><a href='#L87'>87</a>
+<a name='L88'></a><a href='#L88'>88</a>
+<a name='L89'></a><a href='#L89'>89</a>
+<a name='L90'></a><a href='#L90'>90</a>
+<a name='L91'></a><a href='#L91'>91</a>
+<a name='L92'></a><a href='#L92'>92</a>
+<a name='L93'></a><a href='#L93'>93</a>
+<a name='L94'></a><a href='#L94'>94</a>
+<a name='L95'></a><a href='#L95'>95</a>
+<a name='L96'></a><a href='#L96'>96</a>
+<a name='L97'></a><a href='#L97'>97</a>
+<a name='L98'></a><a href='#L98'>98</a>
+<a name='L99'></a><a href='#L99'>99</a>
+<a name='L100'></a><a href='#L100'>100</a>
+<a name='L101'></a><a href='#L101'>101</a>
+<a name='L102'></a><a href='#L102'>102</a>
+<a name='L103'></a><a href='#L103'>103</a>
+<a name='L104'></a><a href='#L104'>104</a>
+<a name='L105'></a><a href='#L105'>105</a>
+<a name='L106'></a><a href='#L106'>106</a>
+<a name='L107'></a><a href='#L107'>107</a>
+<a name='L108'></a><a href='#L108'>108</a>
+<a name='L109'></a><a href='#L109'>109</a>
+<a name='L110'></a><a href='#L110'>110</a>
+<a name='L111'></a><a href='#L111'>111</a>
+<a name='L112'></a><a href='#L112'>112</a>
+<a name='L113'></a><a href='#L113'>113</a>
+<a name='L114'></a><a href='#L114'>114</a>
+<a name='L115'></a><a href='#L115'>115</a>
+<a name='L116'></a><a href='#L116'>116</a>
+<a name='L117'></a><a href='#L117'>117</a>
+<a name='L118'></a><a href='#L118'>118</a>
+<a name='L119'></a><a href='#L119'>119</a>
+<a name='L120'></a><a href='#L120'>120</a>
+<a name='L121'></a><a href='#L121'>121</a>
+<a name='L122'></a><a href='#L122'>122</a>
+<a name='L123'></a><a href='#L123'>123</a>
+<a name='L124'></a><a href='#L124'>124</a>
+<a name='L125'></a><a href='#L125'>125</a>
+<a name='L126'></a><a href='#L126'>126</a>
+<a name='L127'></a><a href='#L127'>127</a>
+<a name='L128'></a><a href='#L128'>128</a>
+<a name='L129'></a><a href='#L129'>129</a>
+<a name='L130'></a><a href='#L130'>130</a>
+<a name='L131'></a><a href='#L131'>131</a>
+<a name='L132'></a><a href='#L132'>132</a>
+<a name='L133'></a><a href='#L133'>133</a>
+<a name='L134'></a><a href='#L134'>134</a>
+<a name='L135'></a><a href='#L135'>135</a>
+<a name='L136'></a><a href='#L136'>136</a>
+<a name='L137'></a><a href='#L137'>137</a>
+<a name='L138'></a><a href='#L138'>138</a>
+<a name='L139'></a><a href='#L139'>139</a>
+<a name='L140'></a><a href='#L140'>140</a>
+<a name='L141'></a><a href='#L141'>141</a>
+<a name='L142'></a><a href='#L142'>142</a>
+<a name='L143'></a><a href='#L143'>143</a>
+<a name='L144'></a><a href='#L144'>144</a>
+<a name='L145'></a><a href='#L145'>145</a>
+<a name='L146'></a><a href='#L146'>146</a>
+<a name='L147'></a><a href='#L147'>147</a>
+<a name='L148'></a><a href='#L148'>148</a>
+<a name='L149'></a><a href='#L149'>149</a>
+<a name='L150'></a><a href='#L150'>150</a>
+<a name='L151'></a><a href='#L151'>151</a>
+<a name='L152'></a><a href='#L152'>152</a>
+<a name='L153'></a><a href='#L153'>153</a>
+<a name='L154'></a><a href='#L154'>154</a>
+<a name='L155'></a><a href='#L155'>155</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">4722x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">180x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">12191x</span>
+<span class="cline-any cline-yes">81469x</span>
+<span class="cline-any cline-yes">81469x</span>
+<span class="cline-any cline-yes">14139x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">44098x</span>
+<span class="cline-any cline-yes">44087x</span>
+<span class="cline-any cline-yes">44087x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-yes">11x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">12180x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">13952x</span>
+<span class="cline-any cline-yes">13952x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">19826x</span>
+<span class="cline-any cline-yes">19826x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">461884x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-yes">33778x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">const _ = require('lodash');
+const { SemanticAttributes } = require('@opentelemetry/semantic-conventions');
+&nbsp;
+module.exports = function(self) {
+&nbsp;
+  return {
+&nbsp;
+    // Register an old event name to be accepted for a new event name.
+    // If newName is emitted, oldName will be accepted as a synonym in handlers.
+    // Currently supported for Apostrophe core module events only. Not to be
+    // used for module-specific events. Call with just the event name,
+    // not the `apostrophe:` part.
+    aliasEvent(oldName, newName) {
+      self.apos.eventAliases[`apostrophe:${oldName}`] = newName;
+    },
+&nbsp;
+    // Emit an event from this module.
+    //
+    // This is an async function and must be awaited. It will
+    // not complete until all of the event handlers
+    // have resolved, in the order they were registered. Note that
+    // event handlers do not have to be `async` functions unless
+    // they `await` asynchronous things, like database queries.
+    //
+    // Any extra parameters passed after `name` are passed to
+    // the event handlers as parameters, in the order given.
+    //
+    // See also the `on` method.
+&nbsp;
+    async emit(name, ...args) {
+      // Find the event handlers registered under the name
+      // of the module doing the emitting, or its subclasses.
+&nbsp;
+      // The apostrophe core object is an emitter but not a module, so
+      // fake a chain for it.
+      const chain = (self.__meta &amp;&amp; self.__meta.chain) || [
+        {
+          name: 'apostrophe'
+        }
+      ];
+&nbsp;
+      const telemetry = self.apos.telemetry;
+&nbsp;
+      // Create the "outer" span
+      const moduleName = (self.__meta &amp;&amp; self.__meta.name) || <span class="branch-2 cbranch-no" title="branch not covered" >'apostrophe';</span>
+      const spanEmitName = `event:${moduleName}:${name}`;
+      await telemetry.startActiveSpan(spanEmitName, async (spanEmit) =&gt; {
+        spanEmit.setAttribute(SemanticAttributes.CODE_FUNCTION, 'emit');
+        spanEmit.setAttribute(SemanticAttributes.CODE_NAMESPACE, moduleName);
+        spanEmit.setAttribute(telemetry.Attributes.EVENT_MODULE, moduleName);
+        spanEmit.setAttribute(telemetry.Attributes.EVENT_NAME, name);
+&nbsp;
+        for (const entry of chain) {
+          const handlers = self.apos.eventHandlers[entry.name] &amp;&amp; self.apos.eventHandlers[entry.name][name];
+          if (handlers) {
+            for (const handler of handlers) {
+&nbsp;
+              // Create an active "inner" span for each handler using the parent as a context
+              const spanHandlerName = spanEmitName + `:handler:${handler.moduleName}:${handler.handlerName}`;
+              await telemetry.startActiveSpan(spanHandlerName, async (spanHandler) =&gt; {
+                spanHandler.setAttribute(SemanticAttributes.CODE_FUNCTION, handler.handlerName);
+                spanHandler.setAttribute(SemanticAttributes.CODE_NAMESPACE, handler.moduleName);
+                spanHandler.setAttribute(telemetry.Attributes.EVENT_MODULE, moduleName);
+                spanHandler.setAttribute(telemetry.Attributes.EVENT_NAME, name);
+&nbsp;
+                try {
+                  const module = self.apos.modules[handler.moduleName];
+                  const fn = module.compiledHandlers[entry.name][name][handler.handlerName];
+                  // Although we have `self` it can't hurt to
+                  // supply the correct `this`
+                  await fn.apply(module, args);
+                  spanHandler.setStatus({ code: telemetry.api.SpanStatusCode.OK });
+                  spanHandler.end();
+                } catch (err) {
+                  telemetry.handleError(spanHandler, err);
+                  // Be sure to close the parent span as well
+                  spanHandler.end();
+                  spanEmit.end();
+                  throw err;
+                }
+              }, spanEmit);
+            }
+          }
+        }
+&nbsp;
+        spanEmit.end();
+      });
+    },
+&nbsp;
+    // You don't need to call this. It is called for you
+    // if you configure the `handlers` module format section.
+    //
+    // Register an event handler in this module. The
+    // given handler function will be invoked when the given event
+    // name is emitted (see `emit`).
+    //
+    // Your handler may be async. If it is the next
+    // event handler method will not begin running until your
+    // handler resolves. If your handler rejects, the chain
+    // stops and the `emit` method also rejects.
+    //
+    // "What about events of other modules?" Register them
+    // with this `name` syntax: `module-name:methodName`. This is
+    // similar to the "cross-module includes" syntax used
+    // elsewhere in Apostrophe.
+    //
+    // Inheritance trees are followed. If you listen for
+    // on `@apostrophecms/doc-type:beforeInsert`, your handler
+    // will be invoked when that event is emitted by any module
+    // that inherits from that module.
+&nbsp;
+    on(name, handlerName, fn) {
+      let moduleName;
+      let eventName;
+      const index = name.indexOf(':');
+      <span class="missing-if-branch" title="if path not taken" >I</span>if ((typeof handlerName) !== 'string') {
+<span class="cstat-no" title="statement not covered" >        throw new Error('When registering an Apostrophe module event handler, the second argument must be a handler name, not a function. This ensures that event handlers can be overwritten and/or extended with the "super" pattern.');</span>
+      }
+      if (index === -1) {
+        moduleName = self.__meta.name;
+        eventName = name;
+      } else {
+        moduleName = name.substr(0, index);
+        eventName = name.substr(index + 1);
+      }
+      <span class="missing-if-branch" title="if path not taken" >I</span>if (_.camelCase(eventName) === _.camelCase(handlerName)) {
+<span class="cstat-no" title="statement not covered" >        throw new Error('The handler name ' + handlerName + ' is essentially identical to the event name, ' + eventName + '. To prevent conflicts with other handlers, you must give it a distinct name expressing what it actually does with the event.');</span>
+      }
+      eventName = self.apos.eventAliases[`${moduleName}:${eventName}`] || eventName;
+      self.apos.eventHandlers[moduleName] = self.apos.eventHandlers[moduleName] || {};
+      const eh = self.apos.eventHandlers[moduleName];
+      eh[eventName] = eh[eventName] || [];
+      <span class="missing-if-branch" title="if path not taken" >I</span>if (_.find(eh[eventName], function (item) {
+        return (item.moduleName === self.__meta.name) &amp;&amp; (item.handlerName === handlerName);
+      })) {
+        // The "event name and method name must differ" rule helps
+        // prevent this situation, but it is still possible if this
+        // method is called directly and a warning is in order
+<span class="cstat-no" title="statement not covered" >        self.apos.util.warn('The handler name ' + handlerName + ' has been registered twice for the event\n' + eventName + ' in the module ' + self.__meta.name + '. It will only be called once.\n\nYou should rename the method in your code to differ from that in the module\nit extends so they both run.\n\nIf you are intentionally overriding it, use the extendHandlers section.');</span>
+<span class="cstat-no" title="statement not covered" >        return;</span>
+      }
+      eh[eventName].push({
+        moduleName: self.__meta.name,
+        handlerName: handlerName
+      });
+      self.compiledHandlers = self.compiledHandlers || {};
+      self.compiledHandlers[moduleName] = self.compiledHandlers[moduleName] || {};
+      self.compiledHandlers[moduleName][eventName] = self.compiledHandlers[moduleName][eventName] || {};
+      self.compiledHandlers[moduleName][eventName][handlerName] = fn;
+    }
+&nbsp;
+  };
+&nbsp;
+};
+&nbsp;</pre></td></tr></table></pre>
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at Wed Jun 08 2022 11:06:49 GMT+0200 (Central European Summer Time)
+            </div>
+        <script src="../../../../../prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="../../../../../sorter.js"></script>
+        <script src="../../../../../block-navigation.js"></script>
+    </body>
+</html>