What does "return [ ];" mean using JavaScript?

Here's a function:

function getChosenDocs()
{
 
 
  var listview = getListView();
 
  if (!listview || !listview.getSelectedCount())
   
      return [];
 
  var documents = [];
 
  for (var item = listview.item(0); item.exists(); item.gotoNext())
    if (item.getSelected())
      documents.push({Id: item.getAttribute("Id"), library: selectedLibrary.name});
        return documents;
}

I have NEVER seen a variable equal to just brackets [].  When I place an alert() or try catch, the return is "object [Object]".

Can someone please explain this...

Thanks,
pborreggAsked:
Who is Participating?
I wear a lot of hats...

"The solutions and answers provided on Experts Exchange have been extremely helpful to me over the last few years. I wear a lot of hats - Developer, Database Administrator, Help Desk, etc., so I know a lot of things but not a lot about one thing. Experts Exchange gives me answers from people who do know a lot about one thing, in a easy to use platform." -Todd S.

Gurvinder Pal SinghCommented:
it is an empty array
0
StingRaYCommented:
It is returning an empty array;
0
pborreggAuthor Commented:
So what's the point?  I'm trying to capture the documents that have been selected in a listview. But if it's empty, what's the point, right?
0
Determine the Perfect Price for Your IT Services

Do you wonder if your IT business is truly profitable or if you should raise your prices? Learn how to calculate your overhead burden with our free interactive tool and use it to determine the right price for your IT services. Download your free eBook now!

pborreggAuthor Commented:
Or is this the part that I really should concern myself with?

  for (var item = listview.item(0); item.exists(); item.gotoNext())
    if (item.getSelected())
      documents.push({Id: item.getAttribute("Id"), library: selectedLibrary.name});
        return documents;
0
pborreggAuthor Commented:
So, consequently, can I display the elements of the array in an alert() box if I return something other than an empty array?
0
StingRaYCommented:
The point is the returned thing. When you get the returned array, you can loop through the elements inside. The elements are objects of Id and library. When no listview is specified, an empty array is returned to keep the iteration simple.

for example:

var docs = getChosenDocs();
for (x in docs) {
    alert(docs[x].Id);
}

Open in new window


from the code above, you can apply to the returned thing even there is no listview available.
0

Experts Exchange Solution brought to you by

Your issues matter to us.

Facing a tech roadblock? Get the help and guidance you need from experienced professionals who care. Ask your question anytime, anywhere, with no hassle.

Start your 7-day free trial
pborreggAuthor Commented:
OK, great... I'm beginning to understand. Now, in all my years of writing code, I'm surprised, I've never seen anything like this:

for (var item = listview.item(0); item.exists(); item.gotoNext())

I thought it was like this:

for(var i=0;i <= [something];i++)
0
pborreggAuthor Commented:
I ran your code and got and error: "OUT OF STACK SPACE". Weird huh?
0
StingRaYCommented:
Because of getListView() returns an object which let you iterate through its items by .gotoNext().

The for loop below is just a simple structure.
for(var i=0;i <= [something];i++)

Open in new window


The FOR-LOOP syntax is
for(<initialization>;<condition>;<increment/step>)

Open in new window


From "for (var item = listview.item(0); item.exists(); item.gotoNext())", you will get
Initialization = "var item = listview.item(0)"
Condition = "item.exists()"
Increment/Step = "item.gotoNext()"
0
StingRaYCommented:
How do you put my EXAMPLE code in?
0
pborreggAuthor Commented:
I WORKED!!!! YEAH. It was my fault. I renamed the code here for security reasons, but when I put back the original names of the function calls, I got back EXACTLY what I needed. You da man!

Thanks and you got 500 pts.

Peter
0
pborreggAuthor Commented:
This actually works and works well!
0
StingRaYCommented:
You're welcome. :)
0
It's more than this solution.Get answers and train to solve all your tech problems - anytime, anywhere.Try it for free Edge Out The Competitionfor your dream job with proven skills and certifications.Get started today Stand Outas the employee with proven skills.Start learning today for free Move Your Career Forwardwith certification training in the latest technologies.Start your trial today
JavaScript

From novice to tech pro — start learning today.