source: general/genlib/nodejs.xml@ f04d065f

12.2 lazarus trunk xry111/for-12.3
Last change on this file since f04d065f was 0f667d5, checked in by Xi Ruoyao <xry111@…>, 5 weeks ago

nodejs: Update test result, and add test-use-internet note

Without an Internet connection "npm ci" does not work.
  • Property mode set to 100644
File size: 8.3 KB
Line 
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY nodejs-download-http "https://nodejs.org/dist/v&nodejs-version;/node-v&nodejs-version;.tar.xz">
8 <!ENTITY nodejs-download-ftp " ">
9 <!ENTITY nodejs-md5sum "7832164e52741a743106c5aadd34cdee">
10 <!ENTITY nodejs-size "40 MB">
11 <!ENTITY nodejs-buildsize "1.0 GB (add 67 MB for tests)">
12 <!ENTITY nodejs-time "12 SBU (add 2.9 SBU for tests: both using parallelism=8 and 8 CPUs online, parts of the tests will use all online CPUs)">
13]>
14
15<sect1 id="nodejs" xreflabel="nodejs-&nodejs-version;">
16 <?dbhtml filename="nodejs.html"?>
17
18
19 <title>Node.js-&nodejs-version;</title>
20
21 <indexterm zone="nodejs">
22 <primary sortas="a-nodejs">nodejs</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Node.js</title>
27
28 <para>
29 <application>Node.js</application> is a
30 <application>JavaScript</application> runtime built on
31 <application>Chrome's</application> V8 JavaScript engine.
32 </para>
33
34 &lfs121_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>
40 Download (HTTP): <ulink url="&nodejs-download-http;"/>
41 </para>
42 </listitem>
43 <listitem>
44 <para>
45 Download (FTP): <ulink url="&nodejs-download-ftp;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download MD5 sum: &nodejs-md5sum;
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download size: &nodejs-size;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Estimated disk space required: &nodejs-buildsize;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated build time: &nodejs-time;
66 </para>
67 </listitem>
68 </itemizedlist>
69
70<!--
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>
75 Required patch:
76 <ulink url="&patch-root;/node-v&nodejs-version;-icu_69-1.patch"/>
77 </para>
78 </listitem>
79 </itemizedlist>
80-->
81
82 <bridgehead renderas="sect3">Node.js Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="which"/>
87 </para>
88
89 <bridgehead renderas="sect4">Recommended</bridgehead>
90 <para role="recommended">
91 <xref linkend="brotli"/>,
92 <xref linkend="c-ares"/>,
93 <xref linkend="icu"/>,
94 <xref linkend="libuv"/>, and
95 <xref linkend="nghttp2"/>
96 </para>
97
98 <bridgehead renderas="sect4">Optional</bridgehead>
99 <para role="optional">
100 <ulink url="https://github.com/nodejs/http-parser">http-parser</ulink> and
101 <ulink url="https://www.npmjs.com/">npm</ulink> (an internal copy of
102 <command>npm</command> will be installed if not present)
103 </para>
104
105 &test-use-internet;
106
107 </sect2>
108
109 <sect2 role="installation">
110 <title>Installation of Node.js</title>
111
112<!--
113 <para>
114 If Python-3.12 is installed, fix the <command>configure</command> script:
115 </para>
116
117<screen><userinput>sed -e '/python3.11/i command -v python3.12 >/dev/null &amp;&amp; exec python3.12 "$0" "$@"' \
118 -e '/3, 11/s/\(.3, 11.\)/(3, 12), \1/' \
119 -i configure</userinput></screen>
120-->
121
122 <para>
123 Build <application>Node.js</application> by running the following
124 commands:
125 </para>
126
127<screen><userinput>./configure --prefix=/usr \
128 --shared-brotli \
129 --shared-cares \
130 --shared-libuv \
131 --shared-openssl \
132 --shared-nghttp2 \
133 --shared-zlib \
134 --with-intl=system-icu &amp;&amp;
135make</userinput></screen>
136
137 <para>
138 To test the results, issue: <command>make test-only</command>.
139 Out of 4096 tests, 25 in the 'parallel' test suite are known to fail.
140<!--
141Failed tests:
142parallel/test-crypto-dh.js
143parallel/test-https-client-checkServerIdentity.js
144parallel/test-https-strict.js
145parallel/test-process-euid-egid.js
146parallel/test-process-initgroups.js
147parallel/test-process-setgroups.js
148parallel/test-process-uid-gid.js
149parallel/test-tls-alert-handling.js
150parallel/test-tls-cert-regression.js
151parallel/test-tls-client-auth.js
152parallel/test-tls-client-mindhsize.js
153parallel/test-tls-client-getephemeralkeyinfo.js
154parallel/test-tls-client-renegotiation-13.js
155parallel/test-tls-client-verify.js
156- -no-warnings parallel/test-tls-dhe.js
157parallel/test-tls-getcipher.js
158parallel/test-tls-junk-server.js
159parallel/test-tls-multiple-cas-as-string.js
160parallel/test-tls-multi-key.js
161parallel/test-tls-peer-certificate-encoding.js
162parallel/test-tls-set-ciphers.js
163parallel/test-tls-sni-server-client.js
164parallel/test-tls-sni-option.js
165parallel/test-tls-server-verify.js
166parallel/test-tls-junk-closes-server.js
167-->
168 </para>
169
170 <para>
171 Now, as the <systemitem class="username">root</systemitem> user:
172 </para>
173
174<screen role="root"><userinput>make install &amp;&amp;
175ln -sf node /usr/share/doc/node-&nodejs-version;</userinput></screen>
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para>
182 <parameter>--with-intl=system-icu</parameter>: use the system version
183 of <application>icu</application>. Other values are
184 <option>full-icu</option> (to build a local, full
185 <application>icu</application> library) and <option>small-icu</option>
186 (to build a local, minimal <application>icu</application> library).
187 </para>
188
189 <para>
190 <parameter>--shared-{brotli,cares,libuv,nghttp2,openssl,zlib}</parameter>:
191 use the system installed libraries instead of local copies.
192 </para>
193
194 <para>
195 <option>--without-npm</option>: do not build
196 <application>npm</application> (use if you'd like to build a separate
197 <application>npm</application> later).
198 </para>
199
200 <para>
201 <option>--shared-http-parser</option>: use the system
202 installed library instead of a local copy.
203 </para>
204
205 </sect2>
206
207 <sect2 role="content">
208 <title>Contents</title>
209
210 <segmentedlist>
211 <segtitle>Installed Programs</segtitle>
212 <segtitle>Installed Library</segtitle>
213 <segtitle>Installed Directories</segtitle>
214
215 <seglistitem>
216 <seg>
217 corepack, node, npm, and npx
218 </seg>
219 <seg>
220 None
221 </seg>
222 <seg>
223 /usr/include/node,
224 /usr/lib/node_modules/{corepack,npm},
225 /usr/share/doc/{node,node-&nodejs-version;}, and
226 /usr/share/systemtap/tapset
227 </seg>
228 </seglistitem>
229 </segmentedlist>
230
231 <variablelist>
232 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
233 <?dbfo list-presentation="list"?>
234 <?dbhtml list-presentation="table"?>
235
236 <varlistentry id="corepack">
237 <term><command>corepack</command></term>
238 <listitem>
239 <para>
240 is an experimental tool to help with managing versions of package
241 managers.
242 </para>
243 <indexterm zone="nodejs corepack">
244 <primary sortas="b-corepack">corepack</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="node">
250 <term><command>node</command></term>
251 <listitem>
252 <para>
253 is the server-side JavaScript runtime
254 </para>
255 <indexterm zone="nodejs node">
256 <primary sortas="b-node">node</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="npm">
262 <term><command>npm</command></term>
263 <listitem>
264 <para>
265 is the <application>Node.js</application> package manager
266 </para>
267 <indexterm zone="nodejs npm">
268 <primary sortas="b-npm">npm</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry>
274 <term>
275 <filename class="directory">/usr/lib/node_modules/npm/</filename>
276 </term>
277 <listitem>
278 <para>
279 is the installation root for Node.js executables and libraries
280 </para>
281 </listitem>
282 </varlistentry>
283
284 </variablelist>
285
286 </sect2>
287
288</sect1>
Note: See TracBrowser for help on using the repository browser.