initial translation in v8js and v8jsexception

This commit is contained in:
Leonardo Lara Rodrigues
2025-05-29 08:56:48 -03:00
parent 047862d1be
commit d5aef3380a
9 changed files with 628 additions and 0 deletions

View File

@@ -0,0 +1,93 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c44e9cb68b9b65771f9c45db2c07a06c63d71359 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8js.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8Js::__construct</refname>
<refpurpose>Constrói um novo objeto <classname>V8Js</classname></refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<constructorsynopsis>
<modifier>public</modifier> <methodname>V8Js::__construct</methodname>
<methodparam choice="opt"><type>string</type><parameter>object_name</parameter><initializer>"PHP"</initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter>variables</parameter><initializer>array()</initializer></methodparam>
<methodparam choice="opt"><type>array</type><parameter>extensions</parameter><initializer>array()</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>report_uncaught_exceptions</parameter><initializer>&true;</initializer></methodparam>
</constructorsynopsis>
<para>
Constrói um novo objeto <classname>V8Js</classname>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>object_name</parameter></term>
<listitem>
<para>
O nome do objeto passado para Javascript.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>variables</parameter></term>
<listitem>
<para>
Mapa de variáveis PHP que estarão disponíveis em Javascript. Deve ser um <type>array</type> associativo
no formato <literal>array("nome-para-js" =&gt; "nome-da-variável-php")</literal>. O padrão é um array vazio.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>extensions</parameter></term>
<listitem>
<para>
Lista de extensões registradas usando <function>V8Js::registerExtension</function> que devem estar disponíveis
no contexto Javascript do objeto <classname>V8Js</classname> criado.
<note>
<para>
Extensões registradas para serem habilitadas automaticamente não precisam ser listadas neste array.
Além disso, se uma extensão tiver dependências, essas dependências também podem ser omitidas. O padrão é um array vazio.
</para>
</note>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>report_uncaught_exceptions</parameter></term>
<listitem>
<para>
Controla se exceções Javascript não capturadas são reportadas imediatamente ou não. O padrão é &true;. Se definido como &false;
a exceção não capturada pode ser acessada usando <function>V8Js::getPendingException</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,95 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c6e69f3a4f553a8906e1ebcb64a7386c0074d276 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8js.executestring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8Js::executeString</refname>
<refpurpose>Executa uma string como código Javascript</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>mixed</type><methodname>V8Js::executeString</methodname>
<methodparam><type>string</type><parameter>script</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>identifier</parameter><initializer>"V8Js::executeString()"</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer><constant>V8Js::FLAG_NONE</constant></initializer></methodparam>
</methodsynopsis>
<para>
Compila e executa a string passada com <parameter>script</parameter> como código Javascript.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>script</parameter></term>
<listitem>
<para>
A string do código a ser executado.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>identifier</parameter></term>
<listitem>
<para>
String identificadora do código executado. Usada para depuração.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>flags</parameter></term>
<listitem>
<para>
Sinalizadores de execução. Este valor deve ser uma das constantes
<literal>V8Js::FLAG_*</literal>, cujo padrão é
<constant>V8Js::FLAG_NONE</constant>.
<itemizedlist>
<listitem>
<para>
<constant>V8Js::FLAG_NONE</constant>: nenhum sinalizador
</para>
</listitem>
<listitem>
<para>
<constant>V8Js::FLAG_FORCE_ARRAY</constant>: força todos os objetos Javascript
passados ao PHP a serem arrays associativos
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna a última variável instanciada no código Javascript convertida para o tipo de variável PHP correspondente.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,54 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c6e69f3a4f553a8906e1ebcb64a7386c0074d276 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8js.getextensions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8Js::getExtensions</refname>
<refpurpose>Retorna um array de extensões registradas</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <modifier>static</modifier> <type>array</type><methodname>V8Js::getExtensions</methodname>
<void />
</methodsynopsis>
<para>
Esta função retorna um array de extensões Javascript registradas usando <function>V8Js::registerExtension</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna um array de extensões registradas ou um array vazio se não houver nenhuma.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,55 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8js.getpendingexception" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8Js::getPendingException</refname>
<refpurpose>Retorna exceção Javascript pendente não capturada</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <type>V8JsException</type><methodname>V8Js::getPendingException</methodname>
<void />
</methodsynopsis>
<para>
Retorna qualquer exceção Javascript pendente não capturada como <classname>V8JsException</classname>
resultante de chamadas anteriores de <function>V8Js::executeString</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<classname>V8JsException</classname> ou &null;.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,99 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 04b11e621f6ccf857368d90262f051a8d40c865d Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8js.registerextension" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8Js::registerExtension</refname>
<refpurpose>Registra extensões Javascript para V8Js</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier> <modifier>static</modifier> <type>bool</type><methodname>V8Js::registerExtension</methodname>
<methodparam><type>string</type><parameter>extension_name</parameter></methodparam>
<methodparam><type>string</type><parameter>script</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>dependencies</parameter><initializer>array()</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>auto_enable</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Registra o <parameter>script</parameter> passado como uma extensão a
ser usada em contextos <classname>V8Js</classname>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>extension_name</parameter></term>
<listitem>
<para>
Nome da extensão a ser registrada.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>script</parameter></term>
<listitem>
<para>
O código Javascript a ser registrado.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>dependencies</parameter></term>
<listitem>
<para>
Array de nomes de extensões das quais a extensão a ser registrada depende. Qualquer extensão desse tipo é
ativada automaticamente quando esta extensão é carregada.
<note>
<para>
Todas as extensões, incluindo as dependências, devem ser registradas antes que quaisquer <classname>V8Js</classname>
sejam criados para utilizá-las.
</para>
</note>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>auto_enable</parameter></term>
<listitem>
<para>
Se definido como &true;, a extensão será habilitada automaticamente em todos os contextos <classname>V8Js</classname>.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Retorna &true; se a extensão foi registrada com sucesso, &false; caso contrário.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d3c871ae1e218ab417e15731c9dee930149baad0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8jsexception.getjsfilename" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8JsException::getJsFileName</refname>
<refpurpose>getJsFileName</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>final</modifier> <modifier>public</modifier> <type>string</type><methodname>V8JsException::getJsFileName</methodname>
<void />
</methodsynopsis>
<para>
</para>
&warn.undocumented.func;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d3c871ae1e218ab417e15731c9dee930149baad0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8jsexception.getjslinenumber" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8JsException::getJsLineNumber</refname>
<refpurpose>getJsLineNumber</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>final</modifier> <modifier>public</modifier> <type>int</type><methodname>V8JsException::getJsLineNumber</methodname>
<void />
</methodsynopsis>
<para>
</para>
&warn.undocumented.func;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 50f43946f8dc20160909944e63f3ccd8214ce007 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8jsexception.getjssourceline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8JsException::getJsSourceLine</refname>
<refpurpose>getJsSourceLine</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>final</modifier> <modifier>public</modifier> <type>string</type><methodname>V8JsException::getJsSourceLine</methodname>
<void />
</methodsynopsis>
<para>
</para>
&warn.undocumented.func;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View File

@@ -0,0 +1,58 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d3c871ae1e218ab417e15731c9dee930149baad0 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
<refentry xml:id="v8jsexception.getjstrace" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>V8JsException::getJsTrace</refname>
<refpurpose>getJsTrace</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>final</modifier> <modifier>public</modifier> <type>string</type><methodname>V8JsException::getJsTrace</methodname>
<void />
</methodsynopsis>
<para>
</para>
&warn.undocumented.func;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->