Class Clip

The value is null if the Dynamic-Resource Cache is not enabled, or if the cache is empty.

This property can be set to replace the entire cache. This can be done to modify the existing list of URLs, or to create an entirely new list of URLs.

The value of the property is an array of Strings. Each String is the fully-qualified URL of a Page dynamic resource. The list that is returned is sorted. Any new list that is provided need not be sorted. Null entries in any new list provided are ignored.

Here is an example Script that retrieves the current cache and displays it in the Result:

var urls = $context.currentClip.dynamicResourceCache;
if (urls == null)
{
  $context.result.postMessage($context.result.LEVEL_INFO, "Cache is empty.");
}
else
{
  var text = "";
  for each (var url in urls))
  {
    text += url + "\n";
  }
  $context.result.postMessage($context.result.LEVEL_INFO, urls.length + " URLs", text);
}

Here is an example Script that replaces the entire current cache with a new list that contains two URLs:

var newList = new Array();
newList[0] = "http://somewhere.com/somepage.html";
newList[1] = "http://someplace.com/index.html";
$context.currentClip.dynamicResourceCache = newList;

Here is an example Script that removes a specific URL from the cache, if it is there:

var list = $context.currentClip.dynamicResourceCache;
if (list != null)
{
  for (var i = 0; i < list.length; i++)
  {
    if (list[i] == "http://somewhere.com/somepage.html")
    {
      list[i] = null;
      $context.currentClip.dynamicResourceCache = list;
      $context.result.postMessage($context.result.LEVEL_INFO, "URL removed.");
      break;
    }
  }
}

Here is an example Script that adds a new URL to the current cache:

var list = $context.currentClip.dynamicResourceCache;
if (list == null)
  list = new Array();
list[list.length] = "http://somewhere.com/somepage.html";
$context.currentClip.dynamicResourceCache = list;

This will include any Targets adopted from nested child Clips through Target merging.

Read only.