Platform App API Modification Proposal

API Namespace: chrome.automation
API Owners: chromeos-a11y-eng@
The following documents may not be necessary depending on the scope of your proposal:
API Overview Doc: N/A
Design Doc: N/A
Supplementary Resources: Add AutomationNode.refreshWithExtraData. This is basically similar to AccessibilityNodeInfo.refreshWithExtraData in Android.

https://developer.android.com/reference/android/view/accessibility/AccessibilityNodeInfo.html#refreshWithExtraData(java.lang.String,%20android.os.Bundle)

idl file change would look like the following.

[FROM HERE - This is not the final]
automation.idl

enum RefreshWithExtraDataKey {
  // Refresh AutomationNode with extra data for |AutomationNode.boundsForRange|.
  // On some platform, those necessary data is not provided by default as it costs high.
  boundsForRange
}

// Called when |refreshWithExtraData| is succeeded or failed.
callback RefreshWithExtraDataCallback = void(boolean success);

... dictionary AutomationNode {
  ...
  // Refresh node with extra data for |key|.
  // This is used to prepare or get data which costs high.
  // |callback| is called once data is obtained or it has failed.
  void refreshWithExtraData(RefreshWithExtraDataKey key, RefreshWithExtraDataCallback callback);
  
  // Returns available extra data keys.
  // Available extra data keys can be different depending on source of AutomationNode.
  RefreshWithExtraDataKey getAvailableExtraDataKeys();
  ...
}
[TO HERE]

I want to first ask whether we need to write API overview doc and design doc for this modification. If necessary, I'm happy to write them. Thank you!