NAME

Data::JavaScript - Dump perl data structures into JavaScript code

SYNOPSIS

use Data::JavaScript;                        # Use defaults

@code =  jsdump('my_array',  $array_ref);    # Return array for formatting
$code =  jsdump('my_object', $hash_ref);     # Return convenient string
$html = hjsdump('my_stuff',  $reference);    # Convenience wrapper for jsdump

DESCRIPTION

This module is mainly inteded for CGI programming, when a perl script generates a page with client side JavaScript code that needs access to structures created on the server.

It works by creating one line of JavaScript code per datum. Therefore, structures cannot be created anonymously and need to be assigned to variables. However, this format enables dumping large structures.

The module can output code for different versions of JavaScript. It currently supports 1.2 and 1.3 and you specify the version on the use line like so:

use Data::JavaScript {JS=>1.3};              # The new default
use Data::JavaScript {JS=>1.2};              # Old format

JavaScript 1.3 contains support for UTF-8 and a native undefined datatype. JavaScript 1.2 supports neither, and will default to an empty string '' for undefined values. You may define your own default--for either version--at compile time by supplying the default value on the use line:

use Data::JavaScript {JS=>1.2, UNDEF=>'null'};

Other useful values might be 0, null, or NaN.

jsdump('name', \$reference, [$undef]);

The first argument is required, the name of JavaScript object to create.

The second argument is required, a hashref or arrayref. Structures can be nested, circular referrencing is supported (experimentally).

The third argument is optional, a scalar whose value is to be used en lieu of undefined values when dumping a structure.

When called in list context, the functions return a list of lines. In scalar context, it returns a string.

hjsdump('name', \$reference, [$undef]);

hjsdump is identical to jsdump except that it wraps the content in script tags.

__quotemeta($str)

Not exported by default, this function escapes non-printable and Unicode characters to promote playing nice with others.

SEE ALSO

perl(1), WDDX.

AUTHOR

Maintained by Jerrad Pierce <jpierce@cpan.org>

Created by Ariel Brosh <schop cpan.org>. Inspired by WDDX.pm JavaScript support.

HISTORY

Previously, the module eval'd any data it received that looked like a number; read: real, hexadecimal, octal, or engineering notations. It now passes non-decimal values through as strings. You will need to eval on the client or server side if you wish to use other notations as numbers.