Template Upload

This commit is contained in:
SOUTHERNCO\x2mjbyrn
2017-05-17 13:45:25 -04:00
parent 415b9c25f3
commit 7efe7605b8
11476 changed files with 2170865 additions and 34 deletions

133
node_modules/weinre/web/doc/Building.html generated vendored Normal file
View File

@ -0,0 +1,133 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Building</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Building</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p>The source repository for weinre is maintained at Apache. See the
archives information on the <a href="Installing.html">Installing</a>
page for more information on downloading a source archive.
<p>If you'd prefer to obtain the source via git, you can use one of the
following repos:
<ul>
<li>Apache repo: <td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
<li>GitHub repo: <td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
</ul>
<p>The Apache repo is the canonical repo. The url can be used in a web
browser, or as the argument of a <tt>git clone</tt> command.
<p>The GitHub repo is a clone of the Apache repo, and automatically shadowed
at some regular interval. The url is the web view of the repo, from
which you can obtain a url to use with <tt>git clone</tt>.
<p>See the file
<tt><a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git;a=blob;f=README.md;hb=HEAD">README.md<a/></tt>
in the top-most directory of the source distribution for more instructions on
how to perform a build. A <a href="https://github.com/apache/cordova-weinre/blob/master/README.md">markdown-processed version of the README file
is available on GitHub</a>.
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

372
node_modules/weinre/web/doc/ChangeLog.html generated vendored Normal file
View File

@ -0,0 +1,372 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - ChangeLog</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - ChangeLog</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<!-- ======================================================================= -->
<h2>2012/??/?? - version 2.0.0</h2>
<ul>
<li><p>port the server from Java to node.js
<li><p>lots of other changes
</ul>
<p>issues resolved:
<ul>
<li><a href="https://issues.apache.org/jira/browse/CB-10">CB-10</a> - Apache source headers in callback-weinre
<li><a href="https://issues.apache.org/jira/browse/CB-36">CB-36</a> - move/delete GitHub issues at phonegap/weinre and callback/callback-weinre into the Apache Callback JIRA
<li><a href="https://issues.apache.org/jira/browse/CB-83">CB-83</a> - implement the server in node
<li><a href="https://issues.apache.org/jira/browse/CB-100">CB-100</a> - fix issues regarding pre-req licenses for weinre distribution
<li><a href="https://issues.apache.org/jira/browse/CB-175">CB-175</a> - error when XHR contentType is null
<li><a href="https://issues.apache.org/jira/browse/CB-176">CB-176</a> - add vendor files to weinre instead of pulling in at build time
<li><a href="https://issues.apache.org/jira/browse/CB-182">CB-182</a> - error when XHR contentType is null
<li><a href="https://issues.apache.org/jira/browse/CB-232">CB-232</a> - rename assets from PhoneGap to Cordova
<li><a href="https://issues.apache.org/jira/browse/CB-257">CB-257</a> - the README.md in the weinre-node distribution is bogus
<li><a href="https://issues.apache.org/jira/browse/CB-259">CB-259</a> - create a weinre tarball as a build archive that is npm install-able
<li><a href="https://issues.apache.org/jira/browse/CB-266">CB-266</a> - weinre runtime error if you don't have a ~/.weinre/server.settings file
<li><a href="https://issues.apache.org/jira/browse/CB-284">CB-284</a> - invocation exception on WeinreClientEventsImpl.connectionCreated(): TypeError: Cannot read property 'url' of undefined
<li><a href="https://issues.apache.org/jira/browse/CB-288">CB-288</a> - re-version as 2.0.0
<li><a href="https://issues.apache.org/jira/browse/CB-293">CB-293</a> - bullet-proof modjewel
<li><a href="https://issues.apache.org/jira/browse/CB-294">CB-294</a> - various exceptions thrown in the target in WeinreTargetEventsImpl.connectionCreated()
<li><a href="https://issues.apache.org/jira/browse/CB-315">CB-315</a> - generate valid Apache release artifact names
<li><a href="https://issues.apache.org/jira/browse/CB-540">CB-540</a> - ability to easily navigate to particular place in DOM via bookmarks/jump to selector
<li><a href="https://issues.apache.org/jira/browse/CB-604">CB-604</a> - weinre doesn't work in strict mode
<li><a href="https://issues.apache.org/jira/browse/CB-873">CB-873</a> - setTimeout() and setInterval() usage with string arguments is busted
<li><a href="https://issues.apache.org/jira/browse/CB-984">CB-984</a> - cannot install weinre with Node 0.8.0
<li><a href="https://issues.apache.org/jira/browse/CB-1666">CB-1666</a> - "INVALID_STATE_ERR: DOM Exception 11" with chbrody/Cordova-SQLitePlugin
<li><a href="https://issues.apache.org/jira/browse/CB-1759">CB-1759</a> - doc indicates that you should launch weinre with a command prefix of `node`
<li><a href="https://issues.apache.org/jira/browse/CB-1193">CB-1193</a> - add Windows Phone support
<li><a href="https://issues.apache.org/jira/browse/CB-1800">CB-1800</a> - remove references to "incubator"
<li><a href="https://issues.apache.org/jira/browse/CB-1494">CB-1494</a> - Supports running server behind a proxy, such as Heroku Cedar
<li><a href="https://issues.apache.org/jira/browse/CB-2650">CB-2650</a> - Weinre style inspection breaks with normalize.css
<li><a href="https://issues.apache.org/jira/browse/CB-3319">CB-3319</a> - Chrome is setting window properties which now breaks Weinre
<li><a href="https://issues.apache.org/jira/browse/CB-3328">CB-3328</a> - chrome version >= 27 breaks flex-box usage
<li><a href="https://issues.apache.org/jira/browse/CB-3378">CB-3378</a> - support for FF and IE10
<li><a href="https://issues.apache.org/jira/browse/CB-6991">CB-6991</a> - Weinre fails to load in browsers without a built-in development console
<li><a href="https://issues.apache.org/jira/browse/CB-7367">CB-7367</a> - allow update of weinre id in page url without page refresh
<li><a href="https://issues.apache.org/jira/browse/CB-7430">CB-7430</a> - weinre does not play nice with npm dedupe
<li><a href="https://issues.apache.org/jira/browse/CB-7437">CB-7437</a> - xhr readystate event passed bad event on some platforms
<li><a href="https://issues.apache.org/jira/browse/CB-7438">CB-7438</a> - weinre target not setting server url when from script's src attribute for https
<li><a href="https://issues.apache.org/jira/browse/CB-5718">CB-5718</a> - Detection of HTTPS broken
</ul>
<!-- ======================================================================= -->
<h2>2011/12/01 - version 1.6.1</h2>
<ul>
<li><p>Error handling for some built-in callbacks has been removed. This function
was added in version 1.6.0. Unfortunately, it had some problems, and it wasn't
clear if the fix was going to make things worse.
</ul>
<p>issues resolved:
<ul>
<li> <a href="https://issues.apache.org/jira/browse/CB-82"> apache/callback issue 82</a> - removeEventListener broken
</uL>
<!-- ======================================================================= -->
<h2>2011/10/28 - version 1.6.0</h2>
<ul>
<li><p>The Network panel has been added to weinre, which will display information
for any XHRs that you issue.
<li><p>Error handling for some built-in callbacks has been added. The support
is very similar to what's provided in the
<a href="https://github.com/pmuellr/log-callback-error">log-callback-error project</a>,
though the implementation is different.
<li><p>The element highlighter has been modified to show brighter colors.
The colors also now more closely match the Web Inspector colors.
Currently, there are some artifacts in the corners in some cases, but it's not
clear to me this is a huge problem - in fact, maybe it's a feachur. ~shrug~
As part of this clean up, I've made the element highlighter pluggable. If you
think you can do better, it should be pretty straight-forward to code up a
new one. Bring it on.
<li><p>The JavaScript code for weinre has been converted from the "scoop" DSL
format to CoffeeScript. You no longer have a valid excuse for not hacking the
code.
<li><p>The "Test Drive" page of the doc has been removed and replaced with
the new "User Interface" page.
<li><p>weinre now adds an "error" listener to window. For JavaScript engines
that support "window onerror", you will now see a message logged to the console
when an error occurs anywhere in your JavaScript code. Unfortunately, just
as support for "window onerror" is becoming available in JavaScript, the browsers
are neutering it's support. Depending on your browser, you may or may not
see these errors reported, and even if you do, they may not give you <b>any</b>
useful information. Thanks to Ryan Seddon for supplying the following
backgrounder links for your enjoyment:
<ul>
<li><a href="http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-September/033252.html">http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2011-September/033252.html</a>
<li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=568564">https://bugzilla.mozilla.org/show_bug.cgi?id=568564</a>
<li><a href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=14177">http://www.w3.org/Bugs/Public/show_bug.cgi?id=14177</a>
<li><a href="https://bugs.webkit.org/show_bug.cgi?id=70574">https://bugs.webkit.org/show_bug.cgi?id=70574</a>
</ul>
</ul>
<p>issues resolved:
<ul>
<li> <a href="https://issues.apache.org/jira/browse/CB-1"> issue apache/callback issue 1</a> - update the doc
<li> <a href="https://github.com/phonegap/weinre/issues/41"> issue phonegap/weinre 41</a> - add support for XHRs on Network panel
<li> <a href="https://github.com/phonegap/weinre/issues/40"> issue phonegap/weinre 40</a> - clean up spurious messages in the server console
<li> <a href="https://github.com/phonegap/weinre/issues/38"> issue phonegap/weinre 38</a> - cleanup some of the exception handler bits
<li> <a href="https://github.com/phonegap/weinre/issues/37"> issue phonegap/weinre 37</a> - Timeout function does not pass arguments
<li> <a href="https://github.com/phonegap/weinre/issues/35"> issue phonegap/weinre 35</a> - convert JavaScript in weinre from scoop to CoffeeScript
<li> <a href="https://github.com/phonegap/weinre/issues/20"> issue phonegap/weinre 20</a> - add support for window.onerror
<li> <a href="https://github.com/phonegap/weinre/issues/19"> issue phonegap/weinre 19</a> - 404 error on /client/index.html in Mac app (incomplete build?)
<li> <a href="https://github.com/phonegap/weinre/issues/11"> issue phonegap/weinre 11</a> - provide better error handling - by hook or by crook
<li> <a href="https://github.com/phonegap/weinre/issues/10"> issue phonegap/weinre 10</a> - element highlighter code in the target is just awful
</ul>
<!-- ======================================================================= -->
<h2>2011/07/22 - version 1.5.0</h2>
<ul>
<li><p>The Resources panel now includes an active Databases section. For any WebSQL
database that you open, you should see an entry in the expanded section. For each database,
you'll see the list of tables owned by the database when the database section
is expanded. Note that you need to open
the database to see it listed here. Databases which you have previously created
in other browsing sessions will not be displayed until they are first opened.
<p>Clicking on a database table will dump the database contents to the panel.
Clicking on the database itself will provide a prompter for you to run SQL
commands against that database. For example, entering
<tt>"select * from YourTableNameHere"</tt>
will dump the table contents to the panel.
<li><p>Some of the console functions, like <tt>console.log()</tt>, were not handling
object arguments correctly. You should now see a an object display. For example,
typing <tt>"window"</tt> or <tt>"console.log(window)"</tt> into the console
will show you the same object display for the window.
<li><p>The ant build script did not have the correctly-cased file names for some
of the files, and the build failed. This has been fixed. You should be able
to do a build on Linux, and other case-sensitive file systems.
<li><p>While weinre already removes some of the Web Inspector panels wholesale,
there were still a number of meaningless gee-gaws on the panels that we do show.
Those have been surgically removed with CSS.
</ul>
<p>issues closed:
<ul>
<li> <a href="https://github.com/phonegap/weinre/issues/7">issue 7</a> - support for WebSQL
<li> <a href="https://github.com/phonegap/weinre/issues/8">issue 8</a> - console.log() etal don't handle object parameters
<li> <a href="https://github.com/phonegap/weinre/issues/12">issue 12</a> - wrong-cased file names in ant scripts for Linux
<li> <a href="https://github.com/phonegap/weinre/issues/16">issue 16</a> - hide stuff in the Web Inspector UI that's not used
</ul>
<!-- ======================================================================= -->
<h2>2011/05/09 - version 1.4.0</h2>
<ul>
<li> better calculation of object's class name. closes <a href="https://github.com/pmuellr/weinre/issues/41">issue 41</a>.
<li> initial set of changes in for extensions. closes <a href="https://github.com/pmuellr/weinre/issues/8">issue 8</a>.
<li> added json2.js to the mix; part of issue <a href="https://github.com/pmuellr/weinre/issues/45">issue 45</a>.
<li> works with recent scooj release. closes <a href="https://github.com/pmuellr/weinre/issues/52">issue 52</a>.
<li> add non-authenticated multi-user support. closes <a href="https://github.com/pmuellr/weinre/issues/50">issue 50</a>.
See <a href="MultiUser.html">the MultiUser doc page</a> for more information.
</ul>
<p>issues closed:
<ul>
<li> <a href="https://github.com/pmuellr/weinre/issues/8">issue 8</a> - enable extensions
<li> <a href="https://github.com/pmuellr/weinre/issues/41">issue 41</a> - in JSC, inspected object's class is always "object"
<li> <a href="https://github.com/pmuellr/weinre/issues/50">issue 50</a> - add non-authenticated multi-user support
<li> <a href="https://github.com/pmuellr/weinre/issues/52">issue 52</a> - react to recent modjewel / scooj changes
</ul>
<!-- ======================================================================= -->
<h2>2011/04/05 - version 1.3.0</h2>
<ul>
<li> style editing now enabled in Elements panel
<li> localStorage and sessionStorage views enabled in Resources panel
<li> URLs to vendor repos updated for the weinre build
<li> check for bad versions of Prototype.js
</ul>
<p>issues closed:
<ul>
<li><a href="https://github.com/pmuellr/weinre/issues/21">issue 21</a> - add support for localStorage
<li><a href="https://github.com/pmuellr/weinre/issues/35">issue 35</a> - testing local files on IOS
<li><a href="https://github.com/pmuellr/weinre/issues/36">issue 36</a> - element.style cannot be edited
<li><a href="https://github.com/pmuellr/weinre/issues/44">issue 44</a> - update vendor repos
</ul>
<!-- ======================================================================= -->
<h2>2011/03/12 - version 1.2.0</h2>
<ul>
<li> DOM elements are now updated live as they change in the target
<li> more console support; sprintf formatting and expandable object logging
</ul>
<p>issues closed:
<ul>
<li><a href="https://github.com/pmuellr/weinre/issues/27">issue 27</a> - edge case where programmatically created DOM is only picked up partially
<li><a href="https://github.com/pmuellr/weinre/issues/37">issue 37</a> - console.log output doesn't do sprintf-style string interpolations
</ul>
<!-- ======================================================================= -->
<h2>2011/03/02 - version 1.1.0</h2>
<ul>
<li>added Timeline panel; tracks timers, intervals, XHRs, some other events, and
<tt>console.markTimeline(<i>string</i>)</tt>
<li>now showing matching style rules in Elements panel
<li>no more diagnostic messages in the user's console; they are now written
to the server console
<li>caught up to a more recent version of Web Inspector
<li>refactoring, technical debt paydown
</ul>
<p>issues closed:
<ul>
<li><a href='https://github.com/pmuellr/weinre/issues/10'>issue 10</a> - enable Timeline panel, and provide some events
<li><a href='https://github.com/pmuellr/weinre/issues/20'>issue 20</a> - catch up to latest Web Inspector code base
<li><a href='https://github.com/pmuellr/weinre/issues/23'>issue 23</a> - mac app's web pages can't connect to server
<li><a href='https://github.com/pmuellr/weinre/issues/24'>issue 24</a> - weinre server runs slowly on windows
<li><a href='https://github.com/pmuellr/weinre/issues/25'>issue 25</a> - pay down technical debt
<li><a href='https://github.com/pmuellr/weinre/issues/28'>issue 28</a> - create a standalone Java launch
<li><a href='https://github.com/pmuellr/weinre/issues/29'>issue 29</a> - autoconnect does not always work
<li><a href='https://github.com/pmuellr/weinre/issues/30'>issue 30</a> - all-json-idls.js is a pig
<li><a href='https://github.com/pmuellr/weinre/issues/31'>issue 31</a> - redirect error/warn/info/debug messages from client and target to server
<li><a href='https://github.com/pmuellr/weinre/issues/32'>issue 32</a> - monospace font too small everywhere
<li><a href='https://github.com/pmuellr/weinre/issues/33'>issue 33</a> - update doc
</ul>
<!-- ======================================================================= -->
<h2>2011/01/25 - version 1.0.0</h2>
<ul>
<li> Don't display "not implemented" messages. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 19</a>.
<li> Remove node highlighting cruft. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 18</a>.
<li> Add meta element to enable GCF for client. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 17</a>.
<li> Make bookmarklet more portable. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 16</a>.
<li> Enable node highlighting. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 2</a>.
<li> Change copyright statements. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 13</a>.
<li> Change Weinre.Console to Console. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 11</a>.
<li> Add implementation for settings. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 5</a>.
<li> Provide better escape for // comments in minifier. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 6</a>.
<li> Get metrics working in Elements panel. Closes <a href="https://github.com/pmuellr/weinre/issues/1">issue 1</a>.
</ul>
<!-- ======================================================================= -->
<h2>2010/12/16 - version 0.9.9</h2>
<ul>
<li>initial release
</ul>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

280
node_modules/weinre/web/doc/Home.html generated vendored Normal file
View File

@ -0,0 +1,280 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Home</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Home</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p><span class="weinre">weinre</span> is <b>WE</b>b <b>IN</b>spector <b>RE</b>mote.
Pronounced like the word "winery". Or maybe like the word "weiner". Who knows,
really.
<p><span class="weinre">weinre</span> is a debugger for web pages, like
FireBug (for FireFox)
and
Web Inspector (for WebKit-based browsers), except it's designed
to work <b>remotely</b>, and in particular, to <b>allow you debug web pages
on a mobile device such as a phone</b>.
<p>Interesting places to visit:
<table>
<tr><td>videos at YouTube:
<td><a href="http://www.youtube.com/results?search_query=weinre">http://www.youtube.com/results?search_query=weinre</a>
<tr><td>this documentation:
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
<tr><td>unofficial binary packages:
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
<tr><td>issues:
<td><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?jqlQuery=project=CB+and+component=weinre">https://issues.apache.org/jira/gobble-de-gook/...</a>
<tr><td>create a new issue:
<td>
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=1">bug</a>
or
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=2">new feature</a>
<tr><td>cloneable source at Apache:
<td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
<tr><td>Apache repo cloned at GitHub:
<td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
<tr><td>mailing lists at Apache:
<td><a href="http://mail-archives.apache.org/mod_mbox/cordova-dev/">http://mail-archives.apache.org/mod_mbox/cordova-dev/</a> (for weinre development)
<tr><td>discussion at Google Group:
<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a> (for weinre usage)
</table>
<p>More information on <span class="weinre">weinre</span>'s big brothers, Web Inspector / Google Chrome
Developer Tools, is available at
<a href="http://code.google.com/chrome/devtools/docs/overview.html">Google's Chrome Dev Tools pages</a>
and
<a href="http://developer.apple.com/library/safari/#documentation/appleapplications/Conceptual/Safari_Developer_Guide/DebuggingYourWebsite/DebuggingYourWebsite.html">Apple's Web Inspector pages</a>.
<p>If you aren't familiar with FireBug or Web Inspector,
<span class="weinre">weinre</span> isn't going to make too much sense to you.
<span class="weinre">weinre</span> reuses the user interface code from the
<a href="http://trac.webkit.org/wiki/WebInspector">Web Inspector project at WebKit</a>,
so if you've used Safari's Web Inspector or Chrome's Developer Tools,
<span class="weinre">weinre</span> will be very familiar. If you're not
familiar with Web Inspector, the links above to Google's and Apple's documentation
will be useful.
<p>Here's an example session using <span class="weinre">weinre</span>:
<p><img src="images/weinre-demo.jpg">
<p>Two screen captures are shown above. On the left is the
<span class="weinre">weinre</span> <b>client</b> application, displaying debug
information.
On the right is the <b>target</b> web page, running in Mobile Safari in the iOS Simulator.
<p>In normal usage, you will be running the <b>client</b> application in a browser
on your desktop/laptop, and running a <b>target</b> web page on your mobile device.
<p>In the session above, the debugger is display the Elements panel, with the
embedded console expanded in the bottom third of the window. In the console
area, we've entered two statements:
<pre>
document.body.style.backgroundColor
document.body.style.backgroundColor = "pink"
</pre>
<p>The result of running the first statement shows the value of the body's background style is not set.
The second statement sets the body's background to pink. That horrifying pink
background is then rendered in the <b>target</b>'s window.
<p>In addition, an <tt>h1</tt> element is selected in the upper third of the
Elements panel, which causes the side panels on the right to be filled in with
relevant information. In this case, the matched CSS rules for that <tt>h1</tt>
element are being shown.
<p>If you are familiar with WebKit's Web Inspector,
a partial list of differences between it and <span class="weinre">weinre</span>
are listed below:
<ul class="spaced">
<li><span class="weinre">weinre</span> does not make use of any 'native' code
in the browser, it's all plain old boring JavaScript.
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
it's functionality is limited. For instance, source level debug of JavaScript
is not <span class="strike">possible</span>
<a href="http://lexandera.com/aardwolf/">easy</a>.
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
the debug target code will run on browsers
without specialized debug support. For instance, a browser running on your phone.
<li><span class="weinre">weinre</span> supports 'remote' interaction,
so you can run the debugger user interface on one
machine and can debug a web page running
on another machine. For instance, debug a web page displayed on your phone from your
laptop.
<li>Because <span class="weinre">weinre</span> supports 'remote' interaction,
multiple debug clients can be debugging the same debug target at the same time.
<li>One thing <b>not</b> different from Web Inspector is that the debug client
user interface only runs on WebKit-based browsers.
</ul>
<!-- ======================================================== -->
<h2>Supported Libraries and Platforms</h2>
<p>Generally version numbers listed here are the earliest
versions of the relevant thing that have been tested.
Later versions of those things are also hopefully supported,
but let us know.
<h3>Libraries not supported</h3>
<ul>
<li>versions of Prototype.js before version 1.7 are not supported,
as they do not support the <tt>JSON.stringify()</tt> API correctly. You
will get an <tt>alert()</tt> in the web page you are debugging if you
attempt to debug it with <span class="weinre">weinre</span> and you are using an unsupported
version of Prototype.js.
</ul>
<h3>Platforms supported - debug server</h3>
<p>Any platform that supports <a href="http://nodejs.org/">node.js</a>.
<h3>Platforms supported - debug client</h3>
<p>The browser where the debugger user interface runs.
<ul>
<li>Google Chrome
<li>Apple Safari
<li>Other recent-ish WebKit-based browsers
</ul>
<h3>Platforms supported - debug target</h3>
<p>The browser with the page you are debugging.
<ul>
<li>Android Browser application
<li>iOS Mobile Safari application
<li>PhoneGap/Cordova
<li>other
</ul>
<h3>Platforms not supported - debug target</h3>
<ul>
<li>iOS 3.1.3 or earlier
<li>webOS 1.45 or earlier
</ul>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

198
node_modules/weinre/web/doc/Installing.html generated vendored Normal file
View File

@ -0,0 +1,198 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Installing</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Installing</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p><span class="weinre">weinre</span> is implemented as a
<a href="http://nodejs.org/">node.js</a> application, and so you'll
need to <a href="http://nodejs.org/download/">download and install
a node runtime</a> to run <span class="weinre">weinre</span>.
<p>To install <span class="weinre">weinre</span>, use <tt>npm</tt>,
or download a binary package. <span class="weinre">weinre</span> is not
sensitive to the directory it's installed in, and does not
write to any files.
<!-- ======================================================================= -->
<h2>npm installation</h2>
<p><span class="weinre">weinre</span> can be installed as an
<a href="http://npmjs.org/doc/README.html">npm package</a>. The
<tt>*-bin.tar.gz</tt> urls/files for binary packages
can be used as a target of the
<a href="http://npmjs.org/doc/install.html"><tt>npm install</tt></a>
command.
<p>It's likely you will want to install <span class="weinre">weinre</span>
globally instead of locally (in the <tt>npm</tt> sense), which means you
will typically want to use the <tt>npm -g</tt> option to install. For
*ix and Mac, this also means prefixing your command with sudo. For Windows,
AFAIK, you don't need sudo or any equivalent.
<p>Here's an example of installing from a binary package via URL:
<pre>
sudo npm -g install http://example.com/path/to/apache-cordova-weinre-X.Y.Z-bin.tar.gz
</pre>
<p><span class="weinre">weinre</span> is also deployed on
<a href="https://npmjs.org/package/weinre">https://npmjs.org/package/weinre</a>
so that you can install it via:
<pre>
sudo npm -g install weinre
</pre>
<!-- ======================================================================= -->
<h2>Binary Packages</h2>
<!--
<p>The recent source and binary release archives should be available at:
<ul>
<li><a href="http://www.apache.org/dyn/closer.cgi/incubator/cordova">http://apache.org/dist/incubator/cordova/</a>
<br><b><i>(at the time of this writing, that link does not actually resolve because
there are no official releases)</i></b>
</ul>
<p>All of the source and binary release archives should be available at:
<ul>
<li><a href="http://archive.apache.org/dist/incubator/cordova/">http://archive.apache.org/dist/incubator/cordova/</a>
<br><b><i>(at the time of this writing, that link does not actually resolve because
there are no official releases)</i></b>
</ul>
-->
<p>Unofficial binary packages for your convenience:
<ul>
<li><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a>
</ul>
<p>The binary packages available are:
<ul>
<li><tt>apache-cordova-weinre-{version}-bin.tar.gz</tt>
<li><tt>apache-cordova-weinre-{version}-bin.zip</tt>
<li><tt>apache-cordova-weinre-{version}-doc.tar.gz</tt>
<li><tt>apache-cordova-weinre-{version}-doc.zip</tt>
<li><tt>apache-cordova-weinre-{version}-src.tar.gz</tt>
<li><tt>apache-cordova-weinre-{version}-src.zip</tt>
</ul>
<p>The difference between the <tt>.tar.gz</tt> and <tt>.zip</tt>
archives is the archive format only. When expanded, both archives
produce the same files.
<p>The <tt>doc</tt> archives contain the stand-alone HTML documentation
<p>The <tt>src</tt> archives contain the ready-to-rebuild source
<p>The <tt>bin</tt> archives contain the ready-to-run binaries
<p>If the <tt>{version}</tt> contains a moniker like <tt>pre</tt>, this
is indicative of an unofficial, non-final binary package for your convenience,
as opposed to an official release.
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

116
node_modules/weinre/web/doc/License.html generated vendored Normal file
View File

@ -0,0 +1,116 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - License</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - License</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p>Source specific to <span class="weinre">weinre</span> is all licensed under the
<a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.
<p><span class="weinre">weinre</span> also makes use of third party code;
the licensing details for those is available in the
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git;a=blob;f=LICENSE;hb=HEAD">LICENSE</a>
file in the top-most directory of the source distribution.
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

196
node_modules/weinre/web/doc/MultiUser.html generated vendored Normal file
View File

@ -0,0 +1,196 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Muli-User</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Muli-User</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p><span class="weinre">weinre</span> was originally designed so that each user
that wanted to use <span class="weinre">weinre</span> would run their own
<span class="weinre">weinre</span> server. The system has since been enhanced
to support muliple users using the same server.
<!-- ======================================================== -->
<h2>Your debug id</h2>
<p>To use a multi-user server, you'll need to select an id for yourself. This
id will be used in the client and target URLs of <span class="weinre">weinre</span>
to scope your clients and targets from the clients and targets of other users.
<p>There is no password, just an id. There is no real security here.
The id is a secret shared between your
debug target and client, but it is sent in the clear when your target and
client connect to the server. If someone else knows your <b>id</b>, they can
connect to clients or targets you are running with that <b>id</b>.
<p>So don't give your <b>id</b> to anyone else that you don't want to share
with.
<p>To keep your <b>id</b>'s familar but non-guessable, you might use a string
consisting of your typical userid, followed by a dash, followed by another
string not likely to be guessed by other people.
<p>If you are paranoid, you can change your <b>id</b> every time you start
a debug session, of course.
<!-- ======================================================== -->
<h2>Using your id with the client</h2>
<p>Typically when start a <span class="weinre">weinre</span> client session
by visiting a URL like
<pre>
http://some.server.xyz/client/
</pre>
<p>To start
a client with a particular id, append the hash character (<code>#</code>) and
the id you want to use the URL. For instance, to connect with the id
<code>itsReallyMe</code>, launch the client with the URL
<pre>
http://some.server.xyz/client/#itsReallyMe
</pre>
<p>The id which is used will be displayed
in the connected clients list for each connected client.
<!-- ======================================================== -->
<h2>Using your id with the target</h2>
<p>As with the server, append the hash character (<code>#</code>) to the
URL of the script being injected into your web page. If you had previously
used a &lt;script src&gt; element of:
<pre>
&lt;script src="http://some.server.xyz/target/target-script-min.js"&gt;&lt;/script&gt;
</pre>
<p>use this script element to connect with id <code>itsReallyMe</code>
<pre>
&lt;script src="http://some.server.xyz/target/target-script-min.js#itsReallyMe"&gt;&lt;/script&gt;
</pre>
<!-- ======================================================== -->
<h2>Notes</h2>
<ul class="spaced">
<li>The <span class="weinre">weinre</span> server always runs in multi-user
mode. If you don't otherwise specify an <b>id</b>, the value of
<code>anonymous</code> will be used for the <b>id</b>.
<li>The <b>id</b> is passed in the HTTP body of a POST request during the
initial connection of the target and client to the server, and is not sent
thereafter. Thus, it should remain out of view in server logs and the like,
though it will be visible for anyone who has access to the contents of
HTTP request bodies.
<li>There is no programmatic interface in <span class="weinre">weinre</span>
to list <b>id</b>'s in current use, for security reasons. From the Remote panel
of weinre, each connected client and target have their channel and id's listed,
if you can't remember what id you used with the client.
</ul>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

384
node_modules/weinre/web/doc/Running.html generated vendored Normal file
View File

@ -0,0 +1,384 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Running</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Running</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p>This page describes how to use <span class="weinre">weinre</span> to debug
your own web pages on a remote device.
<p>First, some background.
<!-- ======================================================== -->
<h2>Terminology</h2>
<p>When using <span class="weinre">weinre</span>, there are three programs interacting with
each other.
<dl class="spaced">
<dt>Debug Server
<dd>This is the HTTP server that you run from the <tt>weinre-node</tt> distribution.
It's the HTTP server that's used by the
<b>Debug Client</b> and <b>Debug Target</b>.
<dt>Debug Client
<dd>This is the Web Inspector user interface; the web page which
displays the Elements and Console panels, for instance.
<dt>Debug Target
<dd>This is your web page that you want to debug. This
name (Debug Target) is also used to refer to the machine
running the browser displaying the web page. Since a design
point of <span class="weinre">weinre</span> is to allow
debugging applications on mobile devices, the debug
target, when speaking of the machine, is your mobile
device.
</dl>
<p>Both the <b>Debug Client</b> and the <b>Debug Target</b> communicate to
the <b>Debug Server</b> via HTTP using <tt>XMLHttpRequest</tt> (XHR).
<p>Typically, you run both the <b>Debug Client</b> and the <b>Debug Server</b>
on your desktop/laptop, and the <b>Debug Target</b> on your mobile device.
<p>The <b>Debug Target</b> is the squirrelliest bit. You
will need to arrange to inject some JavaScript code, provided
by the <b>Debug Server</b>, into your web page, in order for it
to function as a <b>Debug Target</b>.
<!-- ======================================================== -->
<h2>Running the debug server using an <tt>npm</tt> installation</h2>
<p>To run <span class="weinre">weinre</span> from an <tt>npm</tt>
installation, assuming you've installed it globally (in the <tt>npm</tt>
sense), execute the following command:
<pre>
weinre [options]
</pre>
<p>The server will run until you kill it. Control-C will do the job.
<p>Options available are:
<ul class="spaced no-bullet">
<li><tt>--help</tt> (or <tt>-?</tt> or <tt>-h</tt>)
<div class="indent">
<p>Display this help.
</div>
<li><tt>--httpPort [portNumber]</tt>
<div class="indent">
<p>The port to run the HTTP server on.
<p>Default: <tt>8080</tt>
</div>
<li><tt>--boundHost [hostname | ip address | -all-]</tt>
<div class="indent">
<p>The ip address to bind the server to.
<p>Default: <tt>localhost</tt>
<p>With the default of <tt>localhost</tt>, you won't be able to access
the server from any machine other than the one the server is running on. You will
need to bind to another hostname / ip address to make the server accessible to other
machines. You can use the value <tt>-all-</tt> to indicate that you
want to bind to all interfaces available on the current machine.
<p>Use <tt>ifconfig</tt> on Linux or the Mac, and <tt>ipconfig</tt>
on Windows, to get the ip addresses available on your machine.
</div>
<li><tt>--verbose [true | false]</tt>
<div class="indent">
<p>Causes jibberish to be written to stdout
<p>Default: <tt>false</tt>
</div>
<li><tt>--debug [true | false]</tt>
<div class="indent">
<p>Causes even more jibberish to be written to stdout
<p>Default: <tt>false</tt>
</div>
<li><tt>--readTimeout [seconds]</tt>
<div class="indent">
<p>The number of seconds the server will wait for a message
to be available to send to the target or client.
<p>Default: <tt>5</tt>
<p>Can probably be set larger, but then your browser may
time out. Probably don't want to set it much lower than
this as it will cause additional network traffic when
no messages are being sent (it will cause more "empty"
messages to be sent).
</div>
<li><tt>--deathTimeout [seconds]</tt>
<div class="indent">
<p>The number of seconds to wait to hear back from a
debug client or target before declaring them dead.
<p>Default: <tt>3 * readTimeout</tt>
<p>Normally the default will be fine. However, if
you're debugging <span class="weinre">weinre</span> itself, you may wish to set
it much longer.
</div>
</ul>
<!-- ======================================================== -->
<h2>The <tt>~/.weinre/server.properties</tt> file</h2>
<p>You may also create a file named
<tt>server.properties</tt> in the
directory <tt>.weinre</tt> in your
home directory (eg.
<tt>~/.weinre/server.properties</tt>).
Your home directory is the determined by the value of either the
<tt>HOME</tt> or <tt>USERPROFILE</tt> environment variable.
<p>The keys should be
the same as the name of the options above,
with the same values.
<p>As an example, your <tt>~/.weinre/server.properties</tt>
file might look like this:
<pre>
boundHost: -all-
httpPort: 8081
reuseAddr: true
readTimeout: 1
deathTimeout: 5
</pre>
<p>Command-line options override the options specified in the
<tt>~/.weinre/server.properties</tt> file.
<!-- ======================================================== -->
<h2>Running the debug server bound to something other than <tt>localhost</tt></h3>
<p>Since the web page you want to debug (the debug target) is probably running on
a different machine (your mobile device) than the debug server (your desktop / laptop),
you <b>can't</b> use the
default <tt>localhost</tt> value for the <tt>--boundHost</tt>
option. Instead, you will need to specify a host name / ip address
with the <tt>--boundHost</tt> option. This host name / ip address
must be accessible to the machine you want to use as the
debug target.
<p>To get started, you can use the value <tt>-all-</tt> for the
<tt>--boundHost</tt> option.
<p>Now you'll need to figure out what host name / ip address the
debug target should use. If you've use the
<tt>--boundHost -all-</tt> option, then bring up the debug client
using the URL <tt>http://localhost:[portNumber]/client/</tt>
from the same machine the debug server is running on. On that
page, under <b>Server Properties</b>, is a list of bound hosts
that the server believes it's available on.
<p>From the debug target device (eg, your mobile device),
try accessing the server home page
from all of those host names, using the URL
<tt>http://[host name / ipaddress]:[portNumber]/</tt>.
Once you find one
that displays the server's home page correctly, remember
that host name / ip address, we'll be using it in a minute.
<div class="note">
<p>When you run the debug server with a bound host other than
<tt>localhost</tt>, by definition other machines can now access
your debug server. See the <a href="Security.html">Security page</a>
for information on how to protect yourself.
</div>
<!-- ======================================================== -->
<h2>Instrumenting your web page to act as a debug target</h3>
<p>At this point you now have a URL to the debug server which
will be accessible from the debug target. Let's say that URL
(to the debug server's home page) is:
<tt>http://a.b.c:8081</tt>.
<p>To make your web page debuggable with <span class="weinre">weinre</span>,
add the following line to your web page:
<pre>
&lt;script src="http://a.b.c:8081/target/target-script-min.js"&gt;&lt;/script&gt;
</pre>
<p>You can now open a debug client by browsing to
<tt>http://a.b.c:8081/client</tt>
(or probably
<tt>http://localhost:8081/client</tt>
as well) on your desktop/laptop,
then reload your newly instrumented web page on your mobile device,
and see the two connect in the Remote panel of the debug client.
<!-- ======================================================== -->
<h2>Hardcoding host names / IP addresses in your web page?</h3>
<p>Yeah, gross.
<p>Besides being gross, there are a few practical problems with hardcoding the
debug server address in your web page as well:
<ul class="spaced">
<li>Your html file is probably stored in an SCM, and you
don't really want to be storing that address in the SCM.
It won't work for other people using that html file,
for instance.
<p>But you don't want to be keeping the
<tt>&lt;script src=""></tt> line in your SCM either.
You should look for a way, as part of your personal
build process to add that line only for development
builds, and presumably with a user-customizable URL.
<li>The URL the debug server runs on may be
different depending on your location. At work, you may use
one IP address and host name; at home, you likely have a different
IP address and host name. You may not have a host name at all,
just an IP address (which is fine - a host name isn't required,
but usually makes things easier). You may be running on a
dynamically assigned IP address, in which case your IP
changes every time you log into your network.
<p>One way out of the dilemma is to use a dynamic
DNS solution for the the machine you run the debug server on.
Doing a web search on the following terms will provide you
some links to such services:
<a href="http://www.google.com/search?q=dynamic+dns+static+hostname">dynamic dns static hostname</a>
<p>If you use one of these dynamic DNS services, you
can arrange to use the same host name for your debug server
no matter what network you are connected to.
</ul>
<!-- ======================================================== -->
<h2>Using a bookmarklet</h2>
<p>Some platforms support 'bookmarkets', which allow you to inject
arbitrary JavaScript code into any web page running in your
browser. Mobile Safari is one of these browsers. It appears that
the browser shipped with Android 2.2 and later also supports bookmarklets.
<p>Unfortunately, installing bookmarkets on mobile devices isn't usually trivial. The easiest
course of action is to add a new random bookmark to your bookmarks,
and then edit it by hand to change the label and URL. The URL
you should use is available in both a 'pre' and 'textarea' section
of the server's home page (eg, http://localhost:8081/). You should
be able to select the text from one of these areas easily, to
paste into the previously added bookmark.
<p>Once the bookmarklet is installed, you can debug any web page
by visiting it, and selecting the bookmarklet from your bookmarks
menu.
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

155
node_modules/weinre/web/doc/Security.html generated vendored Normal file
View File

@ -0,0 +1,155 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Security</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Security</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p>About security for <span class="weinre">weinre</span>: <b>there is none</b>.
<p>Obviously there should be some. The question is, what do we need to do?
<!-- ======================================================== -->
<h2>Background and potential exposures</h2>
<p>Currently <span class="weinre">weinre</span> uses plain old HTTP - not HTTPS - and provides
no level of authentication for requests.
<p>The primary security exposure with <span class="weinre">weinre</span> is via
the debug server.
<p>Currently, the server only reads files from the weinre-node distribution,
and from the <tt>~/.weinre/</tt> directory (for property files).
The only thing the server writes to is <tt>stdout</tt> and <tt>stderr</tt>.
<p>If you use the default <tt>--boundHost</tt> option value of
<tt>localhost</tt>, then any software on the machine running the debug
server can communicate with the debug server. This probably isn't a big
deal, since presumably you control the software running on that machine.
<p>If you use a non-default <tt>--boundHost</tt> option value,
then <b>any software on any machine that can access that specified
host can communicate with the debug server</b>. This is a much bigger
deal.
<p>The most obvious exposure with using <tt>--boundHost</tt> and
a specific hostname / ip address, is that any debug client or
debug target that can access that hostname / ip address can access
the server. For example, a rogue debug client could connect to
your debug target and fiddle about with it.
<p>Other exposures include leaving a debug target injection
script line (ie, <tt>&lt;script src="[...]/target/target-script.js"&gt;</tt>)
in your web page, and then that web page connects to a rogue debug
server running at that address.
<!-- ======================================================== -->
<h2>Future Implementation Ideas</h2>
<ul class="spaced">
<li>Let's chat
</ul>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

336
node_modules/weinre/web/doc/UserInterface.html generated vendored Normal file
View File

@ -0,0 +1,336 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - User Interface</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - User Interface</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p>This page describes the user interface provided by <span class="weinre">weinre</span>.
<!-- ======================================================================= -->
<h2>the server home page</h2>
<p><img src="images/server-home.png">
<p>The server home page is accessed at the root URL of the server, in this case
<tt>http://localhost:8081/</tt>.
<table><tr><td><img src="images/circled-a.png">
<td>This link will launch the
<span class="weinre">weinre</span> client page, which is the debugger itself.
Clicking this link will take you to the Remote panel, described below.
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>This is the URL of the script that you add to your
web page to allow it to be debugged by the client.
</table>
<p>Additional links shown in this image are for this documentation, and some demo
pages.
<p>Further down on the page, not shown in the image, are:
<ul>
<li>The text of the <tt>&lt;script src=&gt;</tt> element you can copy and paste into your
web page.
<li>The source for a bookmarklet, to inject the debug code into any web
page displayed in your browser.
<li>Version numbers of <span class="weinre">weinre</span> and it's components.
</ul>
<!-- ======================================================================= -->
<h2>the Remote panel</h2>
<p><img src="images/panel-remote.png">
<p>The Remote panel is the initial panel of <span class="weinre">weinre</span>,
and displays some status regarding the server.
<table><tr><td><img src="images/circled-a.png">
<td>The top portion of all of the
<span class="weinre">weinre</span> panels shows the panel switcher. To switch
to a different panel, click on the panel's button. The current panel is displayed with
a highlight, as shown above for the Remote panel.
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>The Targets section of this page lists targets that are currently connected
to the server. A target is a web page that you are debugging.
In this case, there is one target connected the server. Information
about each target is displayed in the list, including host name / ip address, and
the URL the target is displaying.
</table>
<p><table><tr><td><img src="images/circled-c.png">
<td>The Clients section of this page lists the clients that are currently connected
to the server. A client is this user interface. Typically, there is just one - the client you are displaying
at the time.
</table>
<p><table><tr><td><img src="images/circled-d.png">
<td>The Server Properties section of this page displays the values of various server
properties currently in effect. Shown here are the hosts that are bound to the
server - which host names / ip addresses that the server will respond to.
</table>
<p>The colors of the entries in the Targets and Clients list indicates their
status. Blue means the Target or Client is connected to the server, but not
yet connected to a peer. Green means the Target or Client is connected to a
peer, and you can start debugging. Red means the Target or Client has
disconnected from the server, and will eventually fade away and be removed
from the list.
<p>In case there are multiple targets connected, you can switch which one you
are debugging by clicking on the item.
<!-- ======================================================================= -->
<h2>the Elements panel</h2>
<p><img src="images/panel-elements.png">
<p>The Elements panel displays your HTML DOM in a tree fashion, and properties
associated with selected elements.
<table><tr><td><img src="images/circled-a.png">
<td>The elements themselves may be expanded/collapsed via the disclosure buttons.
Elements and text can be edited by double-clicking the item to be edited.
Elements can also be deleted by selecting the element and then pressing the
delete button.
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>The sidebar area displays information about the selected element. In this case,
the Styles sidebar is expanded, showing relevant CSS rules. Some sidebars allow
editing of the contents. The Styles sidebar in particular allows you to add, edit
and remove properties and values by double clicking on them.
</table>
<!-- ======================================================================= -->
<h2>the Resources panel</h2>
<p><img src="images/panel-resources.png">
<p>The Resources panel shows WebSQL databases, and data stored in Local Storage
and Session Storage.
<table><tr><td><img src="images/circled-a.png">
<td>The left hand side of the Resources panel is the navigator. Expanding
the Databases entry will show all the Web SQL databases currently in use.
Expanding a particular database will show all the tables in that database.
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>The right hand side is the editor/viewer for whatever is selected in the
navigator pane.
When a database is selected, a prompt will appear in the editor/viewer area
where you can enter SQL statements to be executed. The results are displayed
inline. When a table is selected, all the rows from the table will be displayed.
When a Local Storage or Session Storage entry is selected, all the relevant keys
and values will be displayed. The keys and values in the Local Storage and
Session Storage tables can be edited by double-clicking.
</table>
<p><table><tr><td><img src="images/circled-c.png">
<td>The reload button will refresh the data from the target.
</table>
<!-- ======================================================================= -->
<h2>the Network panel</h2>
<p><img src="images/panel-network.png">
<p>The Network panel shows you information regarding XHR requests that you've
made.
<table><tr><td><img src="images/circled-a.png">
<td>Each XHR will be shown in a separate row in the table. Clicking the
path name of the XHR request will show additional information for that
request in the right side of the panel.
To display the table again, click the (x)
button in the left top corner of the information pane (not shown in the
image above).
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>The "dots and lines" button can be used to change the table layout to
show less information in a more compact format.
</table>
<p><table><tr><td><img src="images/circled-c.png">
<td>The "not" button will clear the entries from the table.
</table>
<!-- ======================================================================= -->
<h2>the Timeline panel</h2>
<p><img src="images/panel-timeline.png">
<p>The Timeline panel is used to show events that are occurring in the target.
Currently only two types of events are shown: timers/intervals, and user-specified
events. Use <tt>console.markTimeline("A Label")</tt> to add a user-specified
event to the timeline with the specified label.
<p>Note that timing events are not collected unless you enable the "record"
button (see below).
<table><tr><td><img src="images/circled-a.png">
<td>The left hand pane of the Timeline panel shows the events that have occurred.
Hovering over an entry will show additional detail about the event.
</table>
<p><table><tr><td><img src="images/circled-b.png">
<td>The right hand pane of the Timeline panel shows the events as they occurred
in time. Some events have other events associated with them, which will be shown
when the disclosure triangle is expanded. The top-most time line of the right
panel can have it's right and left hand edges moved to show a particular time
range in more detail.
</table>
<p><table><tr><td><img src="images/circled-c.png">
<td>The "dots and lines" button can be used to show and hide events that last
less than a fixed time (currently 15ms).
</table>
<p><table><tr><td><img src="images/circled-d.png">
<td>The "record" button is used to start or stop event collection. When
<span class="weinre">weinre</span> starts, the record button is off (black).
When you click the record button to start collecting events, it will turn
red.
</table>
<p><table><tr><td><img src="images/circled-e.png">
<td>The "not" button will clear the current timing entries.
</table>
<!-- ======================================================================= -->
<h2>the Console panel</h2>
<p><img src="images/panel-console.png">
<p>The Console panel is used to execute arbitrary JavaScript expressions/statements. It
also shows the output from various <tt>console</tt> methods, like
<tt>console.log()</tt>.
<p>In the example above, the JavaScript statements entered by the user are in
blue, the output of the statements is just below it, and messages generated by
<tt>console.log()</tt> are in black.
<table><tr><td><img src="images/circled-a.png">
<td>The "not" button will clear the console.
</table>
<p><img src="images/panel-remote-console.png">
<p>The Console can also be embedded in every panel, by clicking the "console"
button.
<table><tr><td><img src="images/circled-a.png">
<td>The "console" button will embed the console in the bottom half of the
other panels, or hide it if it's currently embedded in the other panels.
</table>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

2
node_modules/weinre/web/doc/build-info.txt generated vendored Normal file
View File

@ -0,0 +1,2 @@
weinre build 2.0.0-pre-I0Z7U9OV by Patrick Mueller
git: 6c1543bc63e75850d29f0bd08a4b5bd1894d972f update for release 2.0.0-pre-HZO3BMNG

185
node_modules/weinre/web/doc/css/main.css generated vendored Normal file
View File

@ -0,0 +1,185 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
body {
padding: 0em 2em;
font-size: 120%
}
/*-----------------------------------------------------------------*/
.ribbon {
position: absolute;
top: 0;
right: 0;
border-left: thin solid #000;
border-bottom: thin solid #000;
-moz-border-radius-bottomleft: 0.5em;
-webkit-border-bottom-left-radius: 0.5em;
padding: 0.25em 0.5em;
background-color: #FF8;
font-style: italic;
-webkit-box-shadow: 5px 5px 15px #888;
-moz-box-shadow: 5px 5px 15px #888;
box-shadow: 5px 5px 15px #888;
}
/*-----------------------------------------------------------------*/
.no-decoration {
text-decoration: none;
}
/*-----------------------------------------------------------------*/
.strike {
text-decoration: line-through;
}
/*-----------------------------------------------------------------*/
.weinre {
color: #088;
font-style: italic;
font-weight: bold;
font-family: Menlo, Monaco, Consolas, Lucida Console, dejavu sans mono, monospace;
}
/*-----------------------------------------------------------------*/
.width-transition {
-webkit-transition: width 0.3s linear;
}
/*-----------------------------------------------------------------*/
.no-bullet {
list-style-type: none;
}
/*-----------------------------------------------------------------*/
.indent {
margin-left: 3.0em;
}
/*-----------------------------------------------------------------*/
.no-bullet li {
margin-top: 0.50em;
margin-bottom: 0.50em;
}
/*-----------------------------------------------------------------*/
.spaced li {
margin-top: 0.50em;
margin-bottom: 0.50em;
}
/*-----------------------------------------------------------------*/
.spaced dt {
margin-top: 0.50em;
}
/*-----------------------------------------------------------------*/
.spaced dd {
margin-bottom: 0.50em;
}
/*-----------------------------------------------------------------*/
dt {
font-weight: bold;
}
tt {
white-space: pre;
}
/*-----------------------------------------------------------------*/
.toc {
font-style: italic;
text-align: center;
}
/*-----------------------------------------------------------------*/
.toc a {
padding: 0.2em 0.5em;
}
/*-----------------------------------------------------------------*/
.page-title {
text-align: center;
}
/*-----------------------------------------------------------------*/
.todo {
background-color: #FAA;
}
/*-----------------------------------------------------------------*/
.help {
background-color: #FDD;
font-weight: bold;
font-size: 120%;
}
/*-----------------------------------------------------------------*/
.note {
background-color: #FFA;
font-weight: bold;
font-size: 120%;
margin: 0.25em 1.0em;
padding: 0.00em 0.5em;
border-width: 1;
border-style: solid;
border-radius: 0.5em;
-moz-border-radius: 0.5em;
-webkit-border-radius: 0.5em;
}
/*-----------------------------------------------------------------*/
pre, xmp {
border-width: 1;
border-style: solid;
overflow: auto;
padding-top: 0.4em;
padding-bottom: 0.4em;
padding-left: 1.4em;
padding-right: 1.4em;
margin-left: 1.4em;
margin-right: 1.4em;
background: #FFFFDF;
border-radius: 0.5em;
-moz-border-radius: 0.5em;
-webkit-border-radius: 0.5em;
box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
-moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
-webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
}
/*-----------------------------------------------------------------*/
h2 {
padding: 0.25em 0.50em;
background-color: #DDD;
border-radius: 0.5em;
-moz-border-radius: 0.5em;
-webkit-border-radius: 0.5em;
}
/*-----------------------------------------------------------------*/
kewl {
box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
-moz-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
-webkit-box-shadow: 0.3em 0.3em 0.3em 0em #DDD;
border-radius: 0.5em;
-moz-border-radius: 0.5em;
-webkit-border-radius: 0.5em;
}

BIN
node_modules/weinre/web/doc/images/circled-a.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 KiB

BIN
node_modules/weinre/web/doc/images/circled-b.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 KiB

BIN
node_modules/weinre/web/doc/images/circled-c.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

BIN
node_modules/weinre/web/doc/images/circled-d.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 KiB

BIN
node_modules/weinre/web/doc/images/circled-e.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

BIN
node_modules/weinre/web/doc/images/circled-f.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

BIN
node_modules/weinre/web/doc/images/circled-g.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 KiB

BIN
node_modules/weinre/web/doc/images/circled-h.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

BIN
node_modules/weinre/web/doc/images/circled-i.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 KiB

BIN
node_modules/weinre/web/doc/images/circled-j.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

BIN
node_modules/weinre/web/doc/images/panel-console.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 123 KiB

BIN
node_modules/weinre/web/doc/images/panel-elements.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 165 KiB

BIN
node_modules/weinre/web/doc/images/panel-network.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 126 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

BIN
node_modules/weinre/web/doc/images/panel-remote.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

BIN
node_modules/weinre/web/doc/images/panel-resources.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 89 KiB

BIN
node_modules/weinre/web/doc/images/panel-timeline.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 115 KiB

BIN
node_modules/weinre/web/doc/images/server-home.png generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

BIN
node_modules/weinre/web/doc/images/weinre-demo.jpg generated vendored Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 422 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 KiB

280
node_modules/weinre/web/doc/index.html generated vendored Normal file
View File

@ -0,0 +1,280 @@
<!doctype html>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<html>
<head>
<title>weinre - Home</title>
<link rel="stylesheet" href="css/main.css" type="text/css">
<link rel="shortcut icon" href="images/weinre-icon-64x64.png" />
</head>
<body>
<div class="ribbon">clone weinre at
<a href="https://git-wip-us.apache.org/repos/asf?p=cordova-weinre.git">apache</a>
</div>
<!-- ======================================================================= -->
<h1 class="page-title">weinre - Home</h1>
<div class="toc">
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<p>
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
</div>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<p><span class="weinre">weinre</span> is <b>WE</b>b <b>IN</b>spector <b>RE</b>mote.
Pronounced like the word "winery". Or maybe like the word "weiner". Who knows,
really.
<p><span class="weinre">weinre</span> is a debugger for web pages, like
FireBug (for FireFox)
and
Web Inspector (for WebKit-based browsers), except it's designed
to work <b>remotely</b>, and in particular, to <b>allow you debug web pages
on a mobile device such as a phone</b>.
<p>Interesting places to visit:
<table>
<tr><td>videos at YouTube:
<td><a href="http://www.youtube.com/results?search_query=weinre">http://www.youtube.com/results?search_query=weinre</a>
<tr><td>this documentation:
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
<tr><td>unofficial binary packages:
<td><a href="http://people.apache.org/~pmuellr/weinre/">http://people.apache.org/~pmuellr/weinre/</a> [temporary]</a>
<tr><td>issues:
<td><a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?jqlQuery=project=CB+and+component=weinre">https://issues.apache.org/jira/gobble-de-gook/...</a>
<tr><td>create a new issue:
<td>
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=1">bug</a>
or
<a href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12312420&components=12316604&issuetype=2">new feature</a>
<tr><td>cloneable source at Apache:
<td><a href="https://git-wip-us.apache.org/repos/asf/cordova-weinre.git">https://git-wip-us.apache.org/repos/asf/cordova-weinre.git</a>
<tr><td>Apache repo cloned at GitHub:
<td><a href="https://github.com/apache/cordova-weinre">https://github.com/apache/cordova-weinre</a>
<tr><td>mailing lists at Apache:
<td><a href="http://mail-archives.apache.org/mod_mbox/cordova-dev/">http://mail-archives.apache.org/mod_mbox/cordova-dev/</a> (for weinre development)
<tr><td>discussion at Google Group:
<td><a href="http://groups.google.com/group/weinre">http://groups.google.com/group/weinre</a> (for weinre usage)
</table>
<p>More information on <span class="weinre">weinre</span>'s big brothers, Web Inspector / Google Chrome
Developer Tools, is available at
<a href="http://code.google.com/chrome/devtools/docs/overview.html">Google's Chrome Dev Tools pages</a>
and
<a href="http://developer.apple.com/library/safari/#documentation/appleapplications/Conceptual/Safari_Developer_Guide/DebuggingYourWebsite/DebuggingYourWebsite.html">Apple's Web Inspector pages</a>.
<p>If you aren't familiar with FireBug or Web Inspector,
<span class="weinre">weinre</span> isn't going to make too much sense to you.
<span class="weinre">weinre</span> reuses the user interface code from the
<a href="http://trac.webkit.org/wiki/WebInspector">Web Inspector project at WebKit</a>,
so if you've used Safari's Web Inspector or Chrome's Developer Tools,
<span class="weinre">weinre</span> will be very familiar. If you're not
familiar with Web Inspector, the links above to Google's and Apple's documentation
will be useful.
<p>Here's an example session using <span class="weinre">weinre</span>:
<p><img src="images/weinre-demo.jpg">
<p>Two screen captures are shown above. On the left is the
<span class="weinre">weinre</span> <b>client</b> application, displaying debug
information.
On the right is the <b>target</b> web page, running in Mobile Safari in the iOS Simulator.
<p>In normal usage, you will be running the <b>client</b> application in a browser
on your desktop/laptop, and running a <b>target</b> web page on your mobile device.
<p>In the session above, the debugger is display the Elements panel, with the
embedded console expanded in the bottom third of the window. In the console
area, we've entered two statements:
<pre>
document.body.style.backgroundColor
document.body.style.backgroundColor = "pink"
</pre>
<p>The result of running the first statement shows the value of the body's background style is not set.
The second statement sets the body's background to pink. That horrifying pink
background is then rendered in the <b>target</b>'s window.
<p>In addition, an <tt>h1</tt> element is selected in the upper third of the
Elements panel, which causes the side panels on the right to be filled in with
relevant information. In this case, the matched CSS rules for that <tt>h1</tt>
element are being shown.
<p>If you are familiar with WebKit's Web Inspector,
a partial list of differences between it and <span class="weinre">weinre</span>
are listed below:
<ul class="spaced">
<li><span class="weinre">weinre</span> does not make use of any 'native' code
in the browser, it's all plain old boring JavaScript.
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
it's functionality is limited. For instance, source level debug of JavaScript
is not <span class="strike">possible</span>
<a href="http://lexandera.com/aardwolf/">easy</a>.
<li>Because <span class="weinre">weinre</span> doesn't use 'native' code,
the debug target code will run on browsers
without specialized debug support. For instance, a browser running on your phone.
<li><span class="weinre">weinre</span> supports 'remote' interaction,
so you can run the debugger user interface on one
machine and can debug a web page running
on another machine. For instance, debug a web page displayed on your phone from your
laptop.
<li>Because <span class="weinre">weinre</span> supports 'remote' interaction,
multiple debug clients can be debugging the same debug target at the same time.
<li>One thing <b>not</b> different from Web Inspector is that the debug client
user interface only runs on WebKit-based browsers.
</ul>
<!-- ======================================================== -->
<h2>Supported Libraries and Platforms</h2>
<p>Generally version numbers listed here are the earliest
versions of the relevant thing that have been tested.
Later versions of those things are also hopefully supported,
but let us know.
<h3>Libraries not supported</h3>
<ul>
<li>versions of Prototype.js before version 1.7 are not supported,
as they do not support the <tt>JSON.stringify()</tt> API correctly. You
will get an <tt>alert()</tt> in the web page you are debugging if you
attempt to debug it with <span class="weinre">weinre</span> and you are using an unsupported
version of Prototype.js.
</ul>
<h3>Platforms supported - debug server</h3>
<p>Any platform that supports <a href="http://nodejs.org/">node.js</a>.
<h3>Platforms supported - debug client</h3>
<p>The browser where the debugger user interface runs.
<ul>
<li>Google Chrome
<li>Apple Safari
<li>Other recent-ish WebKit-based browsers
</ul>
<h3>Platforms supported - debug target</h3>
<p>The browser with the page you are debugging.
<ul>
<li>Android Browser application
<li>iOS Mobile Safari application
<li>PhoneGap/Cordova
<li>other
</ul>
<h3>Platforms not supported - debug target</h3>
<ul>
<li>iOS 3.1.3 or earlier
<li>webOS 1.45 or earlier
</ul>
<!--
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
-->
<div class="toc">
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<p>
<a href="Home.html">Home</a>
- <a href="UserInterface.html">User Interface</a>
- <a href="Installing.html">Installing</a>
- <a href="Running.html">Running</a>
- <a href="MultiUser.html">Multi-User</a>
- <a href="Security.html">Security</a>
- <a href="Building.html">Building</a>
- <a href="ChangeLog.html">ChangeLog</a>
- <a href="License.html">License</a>
<br><img src="images/weinre-icon-128x128.png">
</div>
</body>
</html>

91
node_modules/weinre/web/doc/scripts/main.js generated vendored Normal file
View File

@ -0,0 +1,91 @@
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
//-----------------------------------------------------------------------------
function main() {
// window.addEventListener("load", addClickToExpandImageHandlers, false);
}
//-----------------------------------------------------------------------------
function addClickToExpandImageHandlers() {
var elements = document.getElementsByTagName("img")
for (var i=0; i<elements.length; i++) {
var element = elements[i]
if (!hasClass(element, "expand-on-click")) continue
addClass(element, "width-transition")
element._original_width_ = element.width
element._contracted_ = true
element.width = element.width / 2
element.addEventListener("click", clickToExpand, false)
}
}
//-----------------------------------------------------------------------------
function clickToExpand(event) {
var element = this
if (element._contracted_) {
element.width = element._original_width_
}
else {
element.width = element._original_width_ / 2
}
element._contracted_ = ! element._contracted_
// if (hasClass(element, "contracted")) {
// removeClass(element, "contracted")
// }
//
// else {
// addClass(element, "contracted")
// }
}
//-----------------------------------------------------------------------------
function hasClass(element, className) {
var classNames = element.className.split(/\s+/)
for (var i=0; i<classNames.length; i++) {
if (className == classNames[i]) return true
}
return false
}
//-----------------------------------------------------------------------------
function addClass(element, className) {
if (hasClass(element, className)) return
element.className += " " + className
}
//-----------------------------------------------------------------------------
function removeClass(element, className) {
var classNames = element.className.split(/\s+/)
for (var i=0; i<classNames.length; i++) {
if (className == classNames[i]) {
classNames[i] = ""
}
}
element.className = classNames.join(" ")
}
//-----------------------------------------------------------------------------
main()