4

i have the following javascript below after i finish an ajax query

all of my images have name="pic"

<script type="text/javascript">
 function done() {
     var e = document.getElementsByName("pic");
     alert(e.length);
     for (var i = 0; i < e.length; i++) {
         cvi_instant.add(e[i], { shadow: 75, shade: 10 });
     }
 }

my goal is to apply an image border around using this library:

http://www.netzgesta.de/instant/

the problem is that for some reason this works but it only seem to apply to every other picture instead of every one. any clue why the code above would skip every other element??

EDIT: I added an alert in the loop and it does correctly go 0, 1,2,3,4,5,6 . .

     for (var i = 0; i < e.length; i++)
     {
         alert(i);
         cvi_instant.add(e[i], { shadow: 75, shade: 10 });
     }
leora
  • 188,729
  • 360
  • 878
  • 1,366
  • 1
    I'm going to make an extravagant (and possibly wildly inaccurate) claim. It's because that code (cvi_instant.add) is also using a variable named 'i'. Try calling your variable 'k'. – Noon Silk Sep 22 '09 at 00:20
  • 1
    This should be inaccurate. "i" is declared with "var" so it's not global, and numbers are not passed by reference. However, if there was another "i" declared globally there *might* be a problem. – Glenn Sep 22 '09 at 00:41
  • 1
    Try alerting "i" before the loop (e.g., with the e.length) and tell us what it is. Also, try firebug extension for firefox so you can actually debug and step through the code. This will make things clearer for you. – Glenn Sep 22 '09 at 00:47

4 Answers4

7

it only seem to apply to every other picture instead of every one

That's a classic sign of destructive iteration.

Consider what happens if, as I'm guessing, the function cvi_instant.add replaces the element named pic with some other element or elements.

getElementsByName returns a ‘live’ NodeList: it is kept up to date every time you make a change to the DOM. So if it had five elements before, after your call to cvi_instant.add it now contains only four: the first node is gone and nodes 1–4 have moved down to positions 0–3.

Now you go around the loop again. i++, so we're looking at element 1. But element 1 is now what was originally element 2! We skipped the original element 1, and we will continue skipping every other element until we reach the end of the (now half as long) list.

Altering a list at the same time as iterating it causes this kind of problem. If the process inside the iteration actually adds elements to the list you can even get an infinite loop!

The quick fix is to iterate the loop backwards. Now you do the last element first, leaving all the other elements in their original positions and causing no skipping:

 var e= document.getElementsByName("pic");
 for (var i= e.length; i-->0;) {
     cvi_instant.add(e[i], { shadow: 75, shade: 10 });
 }

Another simple solution if you know you're always going to be removing the element from the list on each call is:

 var e= document.getElementsByName("pic");
 while (e.length>0) {
     cvi_instant.add(e[0], { shadow: 75, shade: 10 });
 }

The most general solution is needed when your loop body can do anything to the list, such as inserting new elements named pic at the start of the document or removing other elements from the middle. It is slightly slower but always safe to make a static copy of the list to work from:

 function Array_fromList(l) {
     var a= [];
     for (var i= 0; i<l.length; i++)
         a.push(l[i]);
     return a;
 }

 var e= Array_fromList(document.getElementsByName("pic"));
 for (var i= 0; i<e.length; i++) {
     cvi_instant.add(e[i], { shadow: 75, shade: 10 });
 }
bobince
  • 528,062
  • 107
  • 651
  • 834
  • thanks for your comments . . do you have any suggestion for a fix here? – leora Sep 22 '09 at 00:51
  • iterating backwards is an interesting "solution" - I rather like it! – TML Sep 22 '09 at 00:59
  • 1
    I wouldn't have expected that the array returned from "getElementsByName" could be modified elsewhere. That's pretty dumb if they're not returning a new, unique array object, – Glenn Sep 22 '09 at 01:01
  • bobince - you are a genius . . iterating backwards did the trick . . – leora Sep 22 '09 at 01:05
  • It's true of all of the document.getElementsBy.... functions. It's pretty much a core feature of the DOM at this point, be glad you haven't been bitten by it yet. – TML Sep 22 '09 at 01:06
  • 1
    Yeah, it's the same NodeList implementation as eg. `document.links` or `document.body.childNodes`, which you kind of expect to be ‘live’, applied consistently throughout the DOM. It's the misleading `get` in the method name that seems to imply you might be getting a static result list. – bobince Sep 22 '09 at 01:14
  • I know this is an old (and correct) answer, but I would like to point out that in your second example with the `while` loop, you do not initialize the variable `i` anywhere, so it is unbound. In addition, you can use the shorter `Array.prototype.slice.call(foo)` to convert `foo` into an array. Unfortunately, this won't work in earlier versions of IE such as IE8 (I haven't tested IE9), but it's very useful in browsers like Chrome and Firefox. – Pauan Aug 13 '11 at 12:07
  • @Pauan: oops! That should have been `e[0]` not `i` of course—fixed, ta. Unfortunately it is only guaranteed safe to call `Array.prototype.slice` (and the other array functions) on native JavaScript objects that have numeric-string members and a `length`. For non-native ‘host objects’, which can include any of the DOM objects, the JS standard makes no guarantees. So IE<9 and other browsers are within spec to not support this and in general you shouldn't use it. – bobince Aug 13 '11 at 12:21
1

My guess is that cvi_instant.add() is doing some incrementing or iteration on the values passed to it. Try doing this instead - it's easier, and I believe it will fix your problem:

function done() {
  var e = document.getElementsByName('pic');
  for (pic in e) { cvs_instant.add(pic, { shadow: 75, shade: 10 }); }
}
TML
  • 12,813
  • 3
  • 38
  • 45
  • when i changed it to this . . the javascript function never ends and none of my pictures get the update.. any ideas? – leora Sep 22 '09 at 00:42
  • "for/in" loop over an array *might* cause problems if you've added methods to the Array prototype (e.g., .bind from prototype.js). "pic" would end up being a function sometimes. – Glenn Sep 22 '09 at 00:43
  • Note that I spelled "cvi_instant" wrong in my sample :) Can you provide us with the body of "cvi_instant" so we can see better what's going on? – TML Sep 22 '09 at 00:46
  • what do you suggest . changing the "name" ?? – leora Sep 22 '09 at 00:47
1

Hi I came across the same problem. My script was skipping every other element. I finally solved it by simply changing the variable name from i to k in my loop. My guess is therefor that the variable i is used by getElementsByTagName internally to keep track of where it is in the live nodelist and is leaking out to the programmers interface somehow. So its a bug! :-)

simon
  • 11
  • 1
0

-- EDIT:

All of what I claim below appears to be totally wrong. I leave this here as a point for anyone who thought the same :) I tested in FF3. I would love to claim that I saw this behaviour once, in IE, but maybe it was many years ago (come to think of it, it was probably 7 years ago). My memory is probably bad :)

-- OLD:

To slightly expand on my wild guess, if it turns out to be accurate:

From memory, if you don't declare a variable ('var ...') it'll use one from somewhere else.

Thus, without testing, this code:

for(var k = 0; k < 2; k++){
    f();
    alert("k: " + k);
}

function f () {
  k++;
}

Should show the same behaviour. I think TML's solution is quite nice, from a 'defensive coding' point of view, it my analysis turns out to be correct.

Noon Silk
  • 54,084
  • 6
  • 88
  • 105