Development:Camino AppleScript Guide - Revision history

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ add a GUI Scripting workaround for new tabs

2012-07-31T20:58:29Z

Anomalies in the Camino AppleScript Dictionary: add a GUI Scripting workaround for new tabs

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ switch link to wayback, add links to "make new" bugs

2012-07-31T20:14:10Z

Anomalies in the Camino AppleScript Dictionary: switch link to wayback, add links to "make new" bugs

Sardisson: /* New in Camino 2.1.3 */ there aren't other kinds, so use "these"

2012-05-10T00:26:45Z

New in Camino 2.1.3: there aren't other kinds, so use "these"

Sardisson: add id docs

2012-04-26T07:10:12Z

add id docs

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ note about prefs window

2012-04-19T20:35:28Z

Anomalies in the Camino AppleScript Dictionary: note about prefs window

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ note broken visit count

2012-02-17T05:14:32Z

Anomalies in the Camino AppleScript Dictionary: note broken visit count

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ oops, 2.1 needs this, too

2012-02-17T04:29:48Z

Anomalies in the Camino AppleScript Dictionary: oops, 2.1 needs this, too

Sardisson: /* Anomalies in the Camino AppleScript Dictionary */ update this now that reload is implemented

2012-02-17T04:29:16Z

Anomalies in the Camino AppleScript Dictionary: update this now that reload is implemented

Sardisson: /* New in Camino 2.1.1 */ add loading in background and reload

2012-02-17T04:25:50Z

New in Camino 2.1.1: add loading in background and reload

Sardisson: /* New in Camino 2.1.1 */ add gurl direct-parameter requirement

2012-02-10T03:21:34Z

New in Camino 2.1.1: add gurl direct-parameter requirement

@@ Line 64: / Line 64: @@
 <dd>&nbsp;
 <dd>If a user has “Links opened by other applications” checked (in the Tabs preference pane), it is possible to use <code>open location "about:blank"</code> to fake opening a new tab and then use <code>set URL of current tab of front browser window</code> to load the desired URL.
-</dl>
+<dd>&nbsp;
 </li>
 <li>Certain items present in the Standard Suite will compile but are not implemented in Camino at this time ({{bug|394581}}).</li>

@@ Line 61: / Line 61: @@
 <li>Making new tabs or browser windows
 <dl>
-<dd>Although the <code>make</code> command is present, it is currently not possible to <code>make new tab</code> or <code>make new browser window</code>.  For technical information about the reasons for this, see [http://summerofcamino.com/comments/bookmarks_check_almost/ this blog post].
+<dd>Although the <code>make</code> command is present, it is currently not possible to <code>make new tab</code> or <code>make new browser window</code>.  For technical information about the reasons for this, see [http://web.archive.org/web/20091119132349/http://2007.summerofcamino.com/comments/bookmarks_check_almost/ this blog post] ({{bug|395711}}, {{bug|395712}}).
 <dd>&nbsp;
 <dd>If a user has “Links opened by other applications” checked (in the Tabs preference pane), it is possible to use <code>open location "about:blank"</code> to fake opening a new tab and then use <code>set URL of current tab of front browser window</code> to load the desired URL.

@@ Line 7: / Line 7: @@
 * Bookmarks IDs
-** The <code>id</code> property is now supported for normal bookmarks and bookmark folders; the <code>id</code> is the bookmark item’s internal [[wikipedia:UUID|UUID]], which is a string.  Bookmarks and folders can now be referenced by their <code>id</code> and parent collection instead of their complete parent hierarchy. The Address Book, Bonjour, and Top Ten List collections do not have <code>id</code>s, nor do bookmarks contained by the Address Book or Bonjour collections (bookmarks in the Top Ten List collection return the same <code>id</code> as they do in whichever collection they normally appear). Bookmarks and bookmark folders without <code>id</code>s return the <code>missing value</code> keyword.
+** The <code>id</code> property is now supported for normal bookmarks and bookmark folders; the <code>id</code> is the bookmark item’s internal [[wikipedia:UUID|UUID]], which is a string.  Bookmarks and folders can now be referenced by their <code>id</code> and parent collection instead of their complete parent hierarchy. The Address Book, Bonjour, and Top Ten List collections do not have <code>id</code>s, nor do bookmarks contained by the Address Book or Bonjour collections (bookmarks in the Top Ten List collection return the same <code>id</code> as they do in whichever collection they normally appear). These bookmarks and bookmark folders without <code>id</code>s return the <code>missing value</code> keyword.
 ==New in Camino 2.1.1==

← Older revision		Revision as of 07:10, 26 April 2012
Line 3:		Line 3:

	Camino 1.6 introduced significant improvements in AppleScript support over previous versions of Camino. Some of these improvements required incompatible changes to commands and properties. Many scripts will continue to work correctly in Camino 1.6 and later; however, scripts that use certain commands and properties, and text scripts (<tt>.applescript</tt>), will need changes in order to continue functioning.		Camino 1.6 introduced significant improvements in AppleScript support over previous versions of Camino. Some of these improvements required incompatible changes to commands and properties. Many scripts will continue to work correctly in Camino 1.6 and later; however, scripts that use certain commands and properties, and text scripts (<tt>.applescript</tt>), will need changes in order to continue functioning.
		+
		+	==New in Camino 2.1.3==
		+
		+	* Bookmarks IDs
		+	** The <code>id</code> property is now supported for normal bookmarks and bookmark folders; the <code>id</code> is the bookmark item’s internal [[wikipedia:UUID\|UUID]], which is a string. Bookmarks and folders can now be referenced by their <code>id</code> and parent collection instead of their complete parent hierarchy. The Address Book, Bonjour, and Top Ten List collections do not have <code>id</code>s, nor do bookmarks contained by the Address Book or Bonjour collections (bookmarks in the Top Ten List collection return the same <code>id</code> as they do in whichever collection they normally appear). Bookmarks and bookmark folders without <code>id</code>s return the <code>missing value</code> keyword.

	==New in Camino 2.1.1==		==New in Camino 2.1.1==

@@ Line 65: / Line 65: @@
 <li>If the user has enabled the “closing windows or quitting with multiple pages open” warnings, these alerts will also fire when AppleScripts attempt to perform these actions.  There is currently no way for the script to disable these alerts on a case-by-case basis ({{Bug|391684}}).<!-- this probably belongs somewhere, but where? --></li>
 <li>“Phantom” windows caused by tooltips (one phantom window per tab, so long as the tab is open) can show up in the count of windows ({{Bug|437802}}).<!-- this probably belongs somewhere, but where? --></li>
 <li>Using UI Scripting to access Camino’s UI can cause toolbar scripts to take forever, time out, or hang Camino.  If you need to use UI Scripting to access Camino UI, run your script from the Script menu instead of as a toolbar script ({{bug|448992}}).</li>
 <li>As of Camino 2.1.1, it now possible to reload a tab or browser window ({{bug|557057}}).  However, if your scripts still need to support Camino 2.1, 2.0.x or 1.6.x, the following script will provide similar functionality:

@@ Line 72: / Line 72: @@
 end tell</pre>
 </li>
 </ul>

@@ Line 66: / Line 66: @@
 <li>“Phantom” windows caused by tooltips (one phantom window per tab, so long as the tab is open) can show up in the count of windows ({{Bug|437802}}).<!-- this probably belongs somewhere, but where? --></li>
 <li>Using UI Scripting to access Camino’s UI can cause toolbar scripts to take forever, time out, or hang Camino.  If you need to use UI Scripting to access Camino UI, run your script from the Script menu instead of as a toolbar script ({{bug|448992}}).</li>
-<li>As of Camino 2.1.1, it now possible to reload a tab or browser window ({{bug|557057}}).  However, if your scripts still need to support Camino 2.0.x or 1.6.x, the following script will provide similar functionality:
+<li>As of Camino 2.1.1, it now possible to reload a tab or browser window ({{bug|557057}}).  However, if your scripts still need to support Camino 2.1, 2.0.x or 1.6.x, the following script will provide similar functionality:
 <pre style="margin-left: 1.5em">tell application "Camino"
      set theURL to URL of current tab of browser window 1

@@ Line 6: / Line 6: @@
 ==New in Camino 2.1.1==
 * Send a referrer when opening URLs
-** The <code>open location</code> command now has an optional <code>using referrer</code> parameter.  If the URL to be opened is already displayed in a tab or window and a referrer is specified, Camino will not reload the existing tab but will instead open a new tab or window to load the requested URL using the supplied referrer.
+** The <code>open location</code> command now has an optional <code>using referrer</code> parameter.  If the URL to be opened is already displayed in a tab or window and a referrer URL is specified, Camino will not reload the existing tab but will instead open a new tab or window to load the requested URL using the supplied referrer URL.
 * New error message for missing or empty direct parameter when opening URLs
-** When the <code>open location</code> command’s direct parameter (the URL to open) is missing or zero-length, Camino will now send an error message to the script.  The direct parameter is no longer marked as optional in Camino’s AppleScript dictionary, but Script Editor may attempt to substitute an implied “current application” direct parameter, which will also trigger the new error message.
+** When the <code>open location</code> command’s direct parameter (the URL to open) is missing or zero-length, Camino will now send an error message to the script.  The direct parameter is no longer marked as optional in Camino’s AppleScript dictionary, but if one is not specified, Script Editor may attempt to substitute an implied “current application” direct parameter, which will also trigger the new error message.
 * Online state (“offline mode”) is now scriptable
 ** Camino’s <code>application</code> object now has an <code>online</code> property, which can be queried to determine if Camino is online or is operating in “offline mode”.  Scripts can also take Camino online and offline by setting the value of the <code>online</code> property.  (Note: No amount of setting <code>online</code> to <code>true</code> will allow Camino to load pages if there is no network connection!)