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 !
 

Latest 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

[edit] Syntax 

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

[edit] Parameters

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

[edit] url

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

[edit] alias

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

[edit] 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");
Retrieved from "http://getfirebug.com/wiki/index.php/Include"
Personal tools