From Facebook Developer Wiki

This page contains history of changes in the JavaScript API. If you want to be kept to date on Facebook JavaScript API, please subscribe to this page.

For general introduction to JavaScript API, please see JavaScript_Client_Library.

Contents 1 7/30/2008 (v=0.4) 2 4/8/2008 (v=0.3) 3 4/3/2008 (v=0.3) 4 3/26/2008 (v=0.2) 5 3/12/2008 (v=0.2) 5.1 New Features 5.2 Bug Fixes 5.3 Demo 6 2/7/2008 6.1 JavaScript Update (v=0.1.2) 6.2 Documentation Update 7 1/25/2008

[edit] 7/30/2008 (v=0.4)

• We rolled out version 0.4 of the Facebook JavaScript Client Library on www.new.facebook.com. To improve performance, we made changes that caused the cross domain communication protocol in the new version to be incompatible with the previous version. We realize that this change makes it more difficult for developers who utilize the iframe resizing feature to transition their applications to new.facebook.com, and we apologize for the inconvenience.

[edit] 4/8/2008 (v=0.3)

1. Rename $ function name to avoid conflict with JQuery and Prototype libraries.
2. Fix a bug in FB_RequireFeatures so that it won't fail when it is called repeatedly after a feature is already loaded.

[edit] 4/3/2008 (v=0.3)

The Facebook JavaScript library was updated in last night’s push. You need to update your script references in order to use this update.

Changes in the update are:

1. Fix an intermittent bug in cross domain communication library that sometimes causes API calls to fail.
2. Slight change to canvas resize function with regard to how content size is calculated.
3. Internal changes related to version updates.

In order to use this update, please make the following changes to your web page:

1. Update your channel page xd_receiver.htm to change the script reference http://static.ak.facebook.com/js/api_lib/v0.2/XdCommReceiver.debug.js to http://static.ak.facebook.com/js/api_lib/v0.3/XdCommReceiver.debug.js.
2. If your xd_receiver.htm has cache control set, as recommended, you need to update any JavaScript code that reference it to force client browser to refresh. For example, if you have code “var api = new FB.ApiClient(“xxx”, '/demo/xd_receiver.htm', null);”, you can change it to “var api = new FB.ApiClient(“xxx”, '/demo/xd_receiver.htm?v=3', null);”.
3. Update all instances of script references from http://static.ak.facebook.com/js/api_lib/v0.2/FeatureLoader.js to http://static.ak.facebook.com/js/api_lib/v0.3/FeatureLoader.js.

[edit] 3/26/2008 (v=0.2)

The Facebook JavaScript library was updated in last night’s push. It contains the following bug fixes:

• Avoid conflict with the $ function in the Prototype library that may be included in an application’s Web page.

• Fix a bug where apiClient.RequireLogin() always redirects back to the callback URL when a login is required. Now it will redirect to the current URL as long as the callback URL string is a prefix of the current URL string. For example, if the callback URL is http://www.foo.com/test, the following URLs can get redirected:
  • http://www.foo.com/test/page2.php
  • http://www.foo.com/test/others/index.php
  • http://www.foo.com/test/

The current URL will not get redirected if it is something like:

• • http://www.bar.com/test/
  • http://www.foo.com/another/page2.php
  • https://www.foo.com/test/

This new behavior is consistent with the RequireLogin function in the PHP client library.

[edit] 3/12/2008 (v=0.2)

This update has new features and breaking changes.

[edit] New Features

• Delayed loading of JavaScript. This change also ensures that your application always loads the most current Facebook JavaScript client.
  Note: This is a breaking change. You need to reference http://static.ak.facebook.com/js/api_lib/v0.2/FeatureLoader.js instead of http://static.ak.facebook.com/js/api_lib/FacebookApi.debug.js. In addition, you need to call FB_RequireFeatures(["Api"], function()) to load API features.
• FB.CanvasClient class
  This new class in the JavaScript client library allows an iframe canvas page to control the size of its hosting iframe element. See Resizable_IFrame for more information.

[edit] Bug Fixes

• Fixed a bug in xd_receiver.htm that sometimes fails to initialize the cross-domain communication library when the needed JavaScript is downloaded for the first time.

Note: To get this fix, you need to update your xd_receiver.htm file. See Cross_Domain_Communication_Channel for instructions.

[edit] Demo

We created some simple demo applications. See JavaScript_Client_Library for details.

[edit] 2/7/2008

Extra permission checks on API calls made by JavaScript library that use a session-based secret:

1. I created an explicit list of APIs that are allowed using session based secret.
2. For profile.getFBML, only allow read of FBML by current user.

[edit] JavaScript Update (v=0.1.2)

1. Fixed or update parameters used in different APIs.
2. Removed support for data API for now because the user level permission check in data API is not ready yet.
3. Updated JSON deserialization so that integer values that are greater than 32bit can be converted to string. This is because JavaScript cannot represent 64 integers accurately. Without this, the photo and album ids can't be stored correctly.
4. Fixed side effect in layout caused by hidden iframes.

[edit] Documentation Update

1. Added Authentication_Model_for_JavaScript_API
2. Added API documentation [[1]]

[edit] 1/25/2008

Initial beta release (v=0.1)