Include

From FirebugWiki

(Difference between revisions)
Jump to: navigation, search
(Changed parts of the formatting to be conform with other Command Line APIs)
m (fix spelling mistake)
(One intermediate revision not shown)
Line 24: Line 24:
== Example of use ==
== Example of use ==
-
Let's assume you want to type a series of commands in the javascript console. And for convenience, you would like to use a Framework (let's say jQuery).
+
The simplest usage is as follow:  
-
 
+
-
But the webpage that you debug does not use it. Fortunately, the ''include'' command allows you to import jQuery:  
+
<source lang="javascript">
<source lang="javascript">
-
include("http://code.jquery.com/jquery-latest.js");
+
include("http://code.jquery.com/jquery-latest.min.js")
</source>
</source>
-
Now you are happy with this ability to use your favorite library on any page. But typing every time the url minds you a lot.
+
If you often include the same script (e.g. jqueryfying your page), you can create a handy alias:
-
Fortunately again(!), you can also create an alias for this URL:
 
<source lang="javascript">
<source lang="javascript">
-
include("http://code.jquery.com/jquery-latest.js", "jquery");
+
include("http://code.jquery.com/jquery-latest.min.js", "jquery")
</source>
</source>
-
and reuse it every time you want by passing the alias instead of the URL when you call ''include'':
+
and reuse it like below:
 +
 
<source lang="javascript">
<source lang="javascript">
-
include("jquery");
+
include("jquery")
</source>
</source>
-
Some time later, you do not remember the alias you have created. To list them, you type this command:  
+
Note that aliases are persistent across Firefox restarts.  
 +
 
 +
To list the aliases, you are offered this command:  
<source lang="javascript">
<source lang="javascript">
include();
include();
Line 52: Line 52:
[[File:IncludeTableExample.png]]
[[File:IncludeTableExample.png]]
-
You notice that you will not use vaporjs anymore. You type this command to delete it:
+
To remove an alias (for example, vaporjs), type this command:
 +
 
<source lang="javascript">
<source lang="javascript">
include(null, "vaporjs");
include(null, "vaporjs");
</source>
</source>
-
 
-
Enjoy !
 

Revision as of 15:52, 12 January 2013

Downloads and executes a remote script in a web page. Especially useful to import libraries for using them inside the Command Line.

Contents

Syntax

include()
include(url[, alias])
include(alias)

Parameters

If include() is written without parameters, it prints a table with all previously specified aliases.

url

URL of the script to include. If set to null, alias is removed. (optional)

alias

Alias name for the included script. (optional for definition, required for usage)

Example of use

The simplest usage is as follow:

include("http://code.jquery.com/jquery-latest.min.js")

If you often include the same script (e.g. jqueryfying your page), you can create a handy alias:

include("http://code.jquery.com/jquery-latest.min.js", "jquery")

and reuse it like below:

include("jquery")

Note that aliases are persistent across Firefox restarts.

To list the aliases, you are offered this command:

include();

And you are returned this table:

IncludeTableExample.png

To remove an alias (for example, vaporjs), type this command:

include(null, "vaporjs");
Personal tools