Mistype in API documentation: list => _list

[KoGor]

JS property list doesn't exist. but there is _list with underscore. Please repair it in code or in docs and examples.

[vlazar]

My 5 cents about current API.

The list property is a bit misleading. There is a setter and it allows to initialize the list of items for completer from different sources:

completer.list = [ "one", "two" ];
completer.list = "one,two";
completer.list = "#selector";
completer.list = $("#selector");

The completer._list property on the other hand always returns Array of strings and underscore in its name implies that it is private.

So is the following code intuitive?

// set list of items
completer.list = "#selector"; // with 2 elements: "one", "two"
// > "#selector"

// get list of items
completer._list;
// > [ "one", "two" ]

I'm started to work on #14565 and it's better not to use _list in tests, as it is private. Having the public API to get the current list of items would be great (not only for tests). However maybe it's better to use different name. Something like:

// get list of items
completer.items;
// > [ "one", "two" ]
// and (maybe) set list of items (always from array)
completer.items = [ "another", "list" ];
// > [ "another", "list" ]

Thoughts?