AJAX Toolkit Developer Guide

AJAX Toolkit Developer Guide
When to Use the AJAX Toolkit
AJAX Toolkit Support Policy
Other Resources
AJAX Typographical Conventions
Sample Visualforce Page Using the AJAX Toolkit
Working with the AJAX Toolkit
API Calls and the AJAX Toolkit
SOAP Header Options with the AJAX Toolkit
Error Handling with the AJAX Toolkit
Advanced Topics
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

When to Use the AJAX Toolkit

For best performance, use the AJAX Toolkit when working with small amounts of data.

Because information is delivered via a browser, AJAX works best with relatively small amounts of data (up to 200 records, approximately six fields with 50 characters of data each). The larger the data set returned, the more time it will take to construct and deconstruct a SOAP message, and as the size of an individual record gets larger, the impact on performance becomes greater. Also, as more HTML nodes are created from the data, the potential for poor performance increases. Because browsers are not efficient, careful consideration needs to be given to browser memory management if you intend to display a large amount of data.

The following are examples of appropriate uses:
  • Display or modify a single record.
  • Display two or three fields from many records.
  • Perform one or more simple calculations, then update a record.
The following are examples of scenarios that require case-by-case analysis:
  • Update more than 200 records.
  • Update records that are unusually large. For example, what happens if the user clicks the browser stop button?
  • Recalculate a complex value for more than 200 records.

An example of inappropriate usage is providing a sortable grid of many records. This would require too much processing time, and browser rendering would be too slow.