Field.removeSelectOption(options)
Method Description |
Removes a select option from certain types of select and multiselect fields. This method is usable only in select fields that were added by a front-end Suitelet or beforeLoad user event script. The IDs for these fields always have a prefix of custpage. |
Returns |
void |
Supported Script Types |
Client scripts For more information, see SuiteScript 2.x Script Types. |
Governance |
None |
Module |
|
Since |
2016.2 |
Parameters
The options parameter is a JavaScript object.
Parameter |
Type |
Required / Optional |
Description |
Since |
---|---|---|---|---|
|
string |
required |
A string, not shown in the UI, that identifies the option. To remove all options from the list, set this field to null, as follows:
|
2016.2 |
Errors
Error Code |
Thrown If |
---|---|
|
A script attempts to use this method on the wrong type of field. This method can be used only on select and multiselect fields whose IDs begin with the prefix custpage. |
Syntax
The following code sample shows the syntax for this member. It is not a functional example. For a complete script example, see N/currentRecord Module Script Samples.
//Add additional code
...
// Instantiate the field. Note that this method is supported only
// on fields whose fieldIds have a prefix of custpage.
var field = call.getField({
fieldId: 'custpage_select1field'
});
// Remove the appropriate option.
field.removeSelectOption({
value: 'Option2',
});
...
//Add additional code